-
PHP项目用AI生成文档注释前，须先配置phpDocumentor等静态分析工具并验证骨架解析正常；AI仅补全内容，不可替代规范，需严格按现有签名、类型（含联合类型）、use语句和异常实际抛出位置生成注释，避免破坏契约或引发解析错误。
-
宝塔面板启动报ModuleNotFoundError:Nomodulenamed'gevent'，本质是Python环境断裂：需用宝塔专属路径/www/server/panel/pyenv/bin/pip安装指定版本的gevent==21.12.0、greenlet==1.1.2、psutil==5.9.4，并规避GLIBC、DNS、pip升级等兼容性问题。
-
belongsTo必须写在「多」方模型中，hasMany必须写在「一」方模型中；外键名、主键名不匹配时需显式传参；预加载需用约束式with()或withCount()；多对多关系需规范中间表名和外键名。
-
堡塔云WAF能有效拦截中小规模CC攻击，但需手动安装启用、配置动态CC防护策略，并避免与宝塔内置流量限制冲突。
-
CI4必须用view()函数显式传参实现布局，不可沿用CI3的$this->load->view()嵌套；CI3通过变量继承自动透传，CI4需手动传递如view('header',['title'=>$title])，否则变量未定义。
-
phpenv不管理php.ini，需手动定位并配置：运行php--ini查看LoadedConfigurationFile路径，若为(none)则从PHP源码复制php.ini-development或php.ini-production并重命名为php.ini。
-
PHP无法直接调用vivoAI语音合成API，因其未开放第三方TTS接口；可行方案是接入阿里云、百度、腾讯等通用TTS云服务或自建espeak-ng方案。
-
核心问题是PHP扩展与mysqld实际生成的mysql.sock路径不一致：需先用mysql-e"showvariableslike'socket'"查真实路径，再同步修改php.ini中mysql.default_socket、mysqli.default_socket、pdo_mysql.default_socket三项为同一路径，并确保mysqld服务正常运行且目录权限正确。
-
PHP持久化连接是将数据库连接归还至进程级连接池复用，并非真正长连接；虽降低建连开销，但易引发事务残留、状态污染、连接数超限等风险，需显式重置会话、避免会话特性依赖并优先采用ProxySQL等中间件替代。
-
PHP8.0中箭头函数（fn）是定义而非调用语法，必须赋值给变量或作为参数传入高阶函数（如array_map）才能执行；不可裸写fn($x)=>$x*2直接运行，也不支持捕获$this，仅自动按值继承父作用域变量。
-
宝塔面板可通过组合配置JumpServer或NextTerminal等开源堡垒机，并启用内置SSH强化、Web终端代理及双因素认证，构建具备资产纳管、会话审计与权限隔离的轻量级堡垒化访问体系。
-
应优先使用mt_rand()；它基于梅森旋转算法，速度快、随机性好、是PHP7.1+默认推荐，而rand()周期短、分布不均、不适用于密码学场景。
-
explode函数可将字符串按分隔符拆分为数组。首先明确其三个参数：分隔符、原字符串和可选的限制数；若分隔符不存在，则返回原字符串组成的数组；使用逗号或空格等作为分隔符时需用引号包裹；当设置正限制数时，数组元素不超过该值，负数则排除末尾若干项；处理空字符串或空分隔符时需注意边界情况，避免警告；对多字节字符需保证编码一致以确保正确分割。
-
PHP日志清理后error_log索引不更新，是因为进程仍持有原文件句柄，持续写入已删除的inode；解决方法是让PHP重开日志文件：FPM用kill-USR2、Apache重启、CLI需手动fclose/reopen。
-
不推荐用fopen()逐字节读写备份，易出错；应优先用copy()，但需确保目标目录存在、有权限，并防源文件被并发写入；大目录备份宜用shell_exec()调用tar，注意路径转义、超时和错误捕获；自动备份必须用crontab或系统任务计划，禁用sleep循环；需按时间/数量清理旧备份并检查磁盘空间。
