-
安装phpEnv应选纯英文无空格路径（如D:\dev\phpenv），避免C:\ProgramFiles；phpenv需先安装php-build插件，Windows下须配php.ini及扩展路径，且phpEnv与phpenv不可混用。
-
Laravel10是带强制门槛的演进版本，PHP8.1为硬性依赖，enum等新语法使低版本无法启动；Feature::define必须在服务提供者中用闭包定义以支持动态灰度；Process::run()返回ProcessResult对象，需显式调用output()；路由缓存不支持闭包路由，须改用控制器或to(fn())语法；make:model默认不生成$fillable，需手动声明以防MassAssignmentException。
-
ob_get_contents()能抓取页面内容是因为它读取PHP输出缓冲区中的快照，不终止也不清空缓冲；常见返回空字符串的原因包括未调用ob_start()、提前输出或缓冲被关闭。
-
PHPAPI返回404的最常见原因是URL未匹配路由规则，需依次检查服务器重写配置、框架路由定义、入口文件加载、.htaccess生效性、框架内部404逻辑及预检OPTIONS请求。
-
宝塔面板CDN回源异常需配置加密校验协议：一、强制HTTPS回源；二、配置可信代理头与协议识别；三、启用源站证书双向校验；四、禁用不安全TLS版本与弱密码套件；五、使用CDN专用回源域名。
-
parse_url()是PHP解析URL字符串唯一推荐的内置函数，能正确处理协议、认证、编码、端口、锚点等边界情况，返回含scheme、host、path等固定键的数组，需先判断返回值是否为false。
-
preg_match_all函数用于PHP中全局正则匹配，返回所有匹配结果；需指定分隔符包裹的模式、引用变量存储结果，并可选PREG_PATTERN_ORDER或PREG_SET_ORDER标志控制数组结构，处理UTF-8时须加u修饰符，注意转义与返回值检查。
-
实现验证码刷新有五种方法：一、AJAX异步更新imgsrc；二、表单提交重生成；三、jQuery简化AJAX；四、Vue响应式绑定；五、Laravel框架集成。
-
宝塔面板默认会话超时为15分钟，可通过面板界面「设置→面板设置→安全设置」修改“会话超时时间”（单位：分钟），或SSH编辑/www/server/panel/config/config.json添加"session_timeout":7200,"cookie_lifetime":7200（单位：秒）并重启面板生效。
-
pcntl_signal在Swoole协程中不触发，因Swoole启动时调用swSignal_none()屏蔽所有线程信号，导致PHP层注册的处理器无法接收信号；必须用Swoole\Process::signal注册且在Server启动前完成。
-
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])，否则变量未定义。
