-
User实体必须显式指定connection，如@ORM\Entity(connection="auth_db")；自定义UserProvider需注入对应EntityManager并手动查询多库；角色表须与User同库，否则需改用非JOIN方式加载。
-
phpEnv不能直接安装ZooKeeper，它仅管理PHP版本与扩展；使用ZooKeeper需单独部署服务端并编译启用zookeeper.so扩展，且二者缺一不可。
-
DomPDF和Snappy生成PDF失败主因是字体配置、路径权限、子进程执行及HTML上下文隔离问题；需注册中文字体、绝对化资源路径、确认wkhtmltopdf路径与权限、校验PDF内容非空。
-
宝塔「强制HTTPS」失效主因是SSL证书未真正启用或Nginx未监听80端口；需确认证书状态为“已启用”且有效期正常，同时确保Nginx监听80端口并正确配置跳转规则与混合内容处理。
-
orderBy仅作用于主表字段，动态排序须白名单校验，关联字段排序需join或withCount，ID置顶用orderByRaw；firstWhere不参与排序。
-
安装路径不能含中文或空格，否则phpenv命令会失效；Windows用户应装到纯英文无空格路径如D:\phpenv，Linux/macOS需注意家目录权限及shell配置文件正确写入与重载。
-
cURL默认超时为0（永不超时），需显式设置CURLOPT_TIMEOUT和CURLOPT_CONNECTTIMEOUT；file_get_contents()超时须通过stream_context_create()配置，与php.ini设置无关；PHP-FPM和Nginx层超时会优先触发终止。
-
PHP中SSL/TLS握手失败大概率是OpenSSL版本过旧或协议协商不匹配，而非代码错误；需检查phpinfo()中OpenSSLLibraryVersion是否≥1.1.1、强制指定CURLOPT_SSLVERSION、配置正确CA证书路径，升级时须重编译PHP而非仅更新系统OpenSSL。
-
PHP的Spl数据结构类是一组内置、优化的数据结构实现，用于提升性能和可维护性。1.SplStack适用于后进先出场景如函数调用栈；2.SplQueue适用于先进先出场景如任务队列；3.SplHeap适合需快速获取最大/最小值的场景如排序；4.SplPriorityQueue基于堆实现优先级处理如任务调度；5.SplFixedArray适合固定大小数组节省内存；6.SplObjectStorage用于对象集合管理与状态跟踪如依赖注入。使用时应根据场景选择合适结构，注意内存分配、引用传递及类型约束，并通过基
-
Yii框架定时任务需通过Console控制器（继承yii\console\Controller，actionXXX方法）配合系统crontab实现，禁用config/console.php中非官方的task配置；crontab须用绝对路径、显式cd切换目录、完整重定向输出，并注意PHPCLI环境一致性。
-
phpEnv不支持界面添加多域名，必须手动编辑vhost下conf文件的server_name行，用空格分隔多个域名，并重载Nginx；HTTPS需SAN证书；调试应使用curl指定Host头验证。
-
排查Swoole问题需调高swoole.log_level至WARNING或DEBUG，检查log_file路径与磁盘空间，结合stats()抓瞬态瓶颈，用listCoroutines()定位协程阻塞，关闭opcache.enable_cli防内存缓涨。
-
PHPStorm识别不到自定义函数是因为未声明其签名；需创建\_ide\_helper.php文件，用function声明+PHPDoc注释，并右键标记为PlainText，最后重载项目索引。
-
Seeder表为空最常见原因是未执行迁移导致表不存在，或唯一索引冲突致插入中断且无提示；安全重跑需手动truncate表并处理外键；Laravel10+必须new实例调用run()；批量插入应避免循环create，改用DB::table()->insert()或分批处理。
-
服务定位器模式在PHP中易成反模式，因其隐式依赖全局容器，导致测试难mock、调用链路不透明、IDE无法提示、静态分析失效，且错误易扩散。
