-
phpEnv的Nginx默认不支持开箱即用自定义错误页，需手动在vhost配置中添加error_page、internallocation及绝对路径root，并确保mime.types正确包含且无路径尾部斜杠，否则404.html将空白或触发下载。
-
Laravel中不存在“EloquentAttributeCustomizationStates”概念；用户定制化显示逻辑应放在APIResource或显式方法中，而非getPriceAttribute()等访问器里，以保持模型职责单一、可测且可维护。
-
rdkafka是PHP集成Kafka的首选方案，因纯PHP客户端易丢消息；需先装librdkafka系统库再peclinstallrdkafka，配置advertised.listeners和group.id等关键参数避免连接失败。
-
Composer需手动安装并绑定phpEnv当前PHP版本，通过shell函数或alias强制调用phpenv激活的php解释器，确保composer--version与php-v版本一致，同时启用openssl、mbstring等必需扩展。
-
ERROR2002(HY000)表示PHP通过Unix套接字连接MySQL失败，主因是socket文件路径不匹配或MySQL服务未启动；需统一修正my.cnf、php.ini及代码中的socket路径，并确保host设为127.0.0.1而非localhost。
-
phpEnv默认不启用mysqli扩展，需手动取消php.ini中extension=mysqli（Linux/macOS）或extension=php_mysqli.dll（Windows）的注释，确认extension_dir路径正确，重启Web服务或PHP-FPM后，通过php-m、phpinfo()和测试代码验证生效。
-
必须分别设置CURLOPT_CONNECTTIMEOUT_MS（如3000）和CURLOPT_TIMEOUT_MS（如10000）以实现双超时，仅用秒级选项或file_get_contents无法精确控制连接阶段超时，且需通过curl_errno区分CURLE_COULDNT_CONNECT与CURLE_OPERATION_TIMEDOUT。
-
ZendGuardLoader仅支持PHP5.2–5.6x86架构，PHP7.0+因ZendEngine重构彻底废弃该扩展；启用需用zend_extension、匹配架构与ZTS模式，并验证php-m|grepzend及.zend文件实际解密效果。
-
PHP接口乱码主因是文件编码非UTF-8无BOM、Content-Type响应头缺失或错误、MySQL连接及表字符集不一致；需统一为UTF-8无BOM，设header('Content-Type:application/json;charset=utf-8')，执行SETNAMESutf8mb4，并逐层验证输出字节。
-
PHP运算符结合性规定同优先级运算符的计算顺序：多数二元运算符（如+、-、*、/、=、.=）左结合，**和赋值类运算符右结合，三元运算符?:左结合但需括号避免弃用警告。
-
PHP扩展未加载导致CodeIgniter数据库连接失败，需确认php.ini路径、extension_dir、扩展文件名及版本匹配，重启Apache并验证扩展是否生效，MySQL8.0+认证协议不兼容时需降级用户认证方式或升级PHP。
-
宝塔插件安装失败主因是HTTPS校验失败、CDN路径失效或出口IP被拦截；需分步排查：curl-k验证SSL、替换download.bt.cn为ghproxy、检查离线源JSON格式、核对并更新授权绑定IP。
-
PHP输出JSON时必须在任何输出前设置header('Content-Type:application/json;charset=utf-8')，否则默认text/html导致解析失败或CORS错误；含中文需显式声明charset；框架中应使用其响应方法而非手动设header。
-
数据库迁移是用PHP代码描述表结构变更，通过up()和down()方法实现可重复、可回退、跨环境执行；必须新建迁移处理变更，禁止修改已执行文件；migrate按时间戳顺序执行并记录批次，rollback按批回退，fresh会清空重跑但生产禁用。
-
phpEnv是Windows下开箱即用的PHP集成环境（含Apache、MySQL及多版本PHP），非Unix系的phpenv；官方唯一可信下载地址为https://www.phpenv.cn/，安装须关闭杀毒软件、路径不含中文或空格、以管理员身份首次运行，并通过“端口检测”解决80/3306端口占用问题。
