-
行为不是事件的替代品，而是可复用的组件扩展机制；它通过events()方法显式绑定事件处理器，内部可监听、触发、转发事件，但自身不自动产生事件，且生命周期由宿主对象管理。
-
Yii2RESTful接口需手动实现sign签名验证与参数校验，签名应在beforeAction中统一处理，参数须原始获取后按字典序拼接并HMAC校验；参数校验不可依赖$request->get()等自动转换，必须先取原始值再通过验证器或filter_var严格校验。
-
灰度发布核心目标是保障数据一致性与业务无感，需通过三阶段演进（兼容写入、双读回填、清理收敛）、PHP层路由开关控制及自动化校验降级实现安全过渡。
-
inotify扩展仅支持Linux，需确认内核启用、PHP已加载且CLI/WebSAPI均生效；监听时用位掩码（如IN_MODIFY）、避免IN_ALL_EVENTS；须用stream_select防阻塞，并及时释放inotify资源以防泄漏。
-
PHP持久化连接是将数据库连接归还至进程级连接池复用，并非真正长连接；虽降低建连开销，但易引发事务残留、状态污染、连接数超限等风险，需显式重置会话、避免会话特性依赖并优先采用ProxySQL等中间件替代。
-
Laravel中间件构造函数不能接收路由参数，所有动态值必须通过handle()方法第三个字符串参数传入；正确写法为CheckRole::class.':admin,editor'，错误写法如"App\Http\Middleware\CheckRole::class:admin"。
-
phpEnv需手动配置sendmail：下载解压sendmail.exe，修改php.ini中sendmail_path指向该路径并重启服务；sendmail.ini须正确设置SMTP服务器、端口、授权码及force_sender；推荐改用PHPMailer直连SMTP更可靠。
-
phpEnv不处理404页面，需按所用Web服务器（Nginx或Apache）手动配置：Nginx在server块中添加error_page404/404.html及对应location；Apache则在项目根目录.htaccess中写ErrorDocument404/404.html；PHP内调用http_response_code(404)仅改状态码，不触发自定义页面。
-
Laravel原生本地化不够用，必须用mcamara/laravel-localization包支持路由前缀、自动重定向、浏览器语言检测和SEO友好URL；App::setLocale()仅影响翻译上下文，不处理路由匹配、链接生成、语言继承等关键环节。
-
应使用whereMorphedTo()获取多态子级数据，它自动处理类型标准化和模型绑定；手动拼接commentable_type易出错且绕过Eloquent机制，无法访问关联属性。
-
WordPress上传失败“文件超过最大允许大小”是宝塔中PHP与Nginx双重限制未对齐所致：需同步设置PHP的upload_max_filesize（如256M）与post_max_size（≥280M），并在Nginx的http{}块内添加client_max_body_size256m，同时修正宝塔面板config.json中的upload_max_size并重启bt-panel。
-
预加载父子关联数据的关键在于条件位置：主表筛选用where()，子表过滤用with()闭包，父子联动需用whereColumn()或whereHas()。
-
Apache多端口配置下DocumentRoot末尾斜杠会导致404，因路径解析误触发重定向；ServerName严禁含/或协议；.htaccess重写需用绝对路径；PHP路径拼接须统一用__DIR__.'/file'；修改后必须重启Apache。
-
WSL2+Ubuntu+VSCode可跑原生PHP环境，但需确保PHP进程由WSL2托管、路径统一、调试直连；推荐Ubuntu24.04手动导入，更新内核、修复权限与头文件路径，VSCode必须用Remote-WSL打开项目并配置正确PHP路径。
-
PHP与Apache手动集成需严格匹配版本、正确配置LoadModule/PHPIniDir/AddHandler，Linux需启用模块并检查php.ini路径，macOS需用proxy_fcgi，验证须测试exec和$_SERVER等真实环境变量。
