-
Laravel部署必须将Nginx的root设为public目录，否则暴露.env等敏感文件且路由404；需配置try_files$uri$uri//index.php?$query_string，并用$realpath_root指定SCRIPT_FILENAME，同时透传HTTPS头并确保APP_URL协议一致。
-
Laravel工厂关联必须用for()或has()显式声明，手动设外键字段（如['post_id'=>1]）不会触发Eloquent关联逻辑，导致user->post返回空；Post::factory()->for(User::factory())表示Post属于User，User::factory()->has(Post::factory()->count(3))表示User拥有3篇Post。
-
宝塔面板多PHP版本环境变量需通过确认路径、临时设置PATH、创建软链接、使用面板切换功能或编辑用户配置文件五种方式管理。具体包括：一、查/www/server/php/{ver}/bin/php路径；二、用PATH=/path:$PATHphp-v临时调用；三、建php74软链接并追加PATH到/etc/profile；四、在站点PHP设置中指定命令行版本；五、向~/.bashrc写入exportPATH实现用户级绑定。
-
PHP8.2的readonly类配合构造器属性提升要求所有promoted属性必须在构造时显式赋值，不可跳过、不可延迟初始化，否则立即报Fatalerror；DI容器、Mock工具、继承等场景均需严格遵循该契约。
-
Laravel迁移是基于时间戳顺序执行的版本化脚本机制，非自动同步工具；必须用phpartisanmake:migration生成文件以确保时间戳唯一、类名匹配、框架预填正确，避免手动修改时间戳或文件名导致执行错乱。
-
PHP8.x必须配Xdebug3.1+，Xdebug3.0.x不支持PHP8.2+；验证需两步：先用php-v确认主次版本（如8.2），再执行php--rixdebug——若返回“notpresent”说明未加载，若卡住或段错误则大概率ABI不兼容。
-
phpEnv中phpMyAdmin升级不可覆盖解压或一键更新，须停用服务、定位至phpenv\versions\{php-version}\apps\phpmyadmin\目录，保留合规config.inc.php后全量替换，并确保PHP≥8.0及启用mbstring、openssl等扩展。
-
set_error_handler仅能捕获E_WARNING、E_NOTICE、E_USER_*等可恢复错误，无法处理E_ERROR、E_PARSE等致命错误；必须返回true才生效；掩码需明确包含目标级别；全局注册应置于入口文件顶部。
-
令牌错误需重置宝塔面板登录状态：一、清除浏览器缓存与Cookie；二、SSH执行btreset或删除userInfo.json并重启；三、重建session.db；四、删除data目录JSON文件并运行btdefault；五、手动生成token_key文件并设权限。
-
应使用lastInsertId()获取自增ID，而非手动插入；批量导入需逐条执行并取ID，事务中须提交后才可安全使用该ID。
-
json_decode()用于将JSON字符串解码为PHP变量，支持返回对象或关联数组（设$assoc=true），需UTF-8编码且兼容RFC7159；json_encode()则反向转换，处理资源等非法类型会返回null。
-
本文详解如何通过PHP正确调用MozAPIv2的URLMetrics接口，提供基于cURL的完整可运行示例，并指出原file_get_contents方案中常见的请求头、认证、数据格式等关键错误。
-
应使用is_array($arr)&&!empty($arr)判断非空数组，避免empty()误判；array_merge()重置数字键而+左优先；遍历时修改数组需用array_filter或延后操作；json_decode保键类型宜用stdClass或加前缀处理。
-
“权限不足”提示但文件上传成功，实为临时文件读取失败，需检查open_basedir、upload_tmp_dir权限及SELinux/AppArmor限制，并验证MySQLINSERT权限与CSV编码、换行符兼容性。
-
Symfony命令交互推荐用SymfonyStyle（自动封装样式/验证/历史），次选QuestionHelper（精细控制多选/补全）；交互仅作参数补充，需判isInteractive()避免非TTY卡住。
