-
Hyperf无法支持SeataAT模式，因其依赖JavaAgent和DataSourceProxy，而Hyperf使用协程PDO无SQL拦截与undo_log能力；XID透传、分支注册、二阶段协调等均不兼容JVM设计；实测出现GlobalSession卡在Begin、Cancel失效等问题。
-
fastcgi_pass配置错误会导致Nginx无法转发PHP请求，常见表现为502、404或500错误；根本原因是Nginx与PHP-FPM监听地址（IP:端口或Unixsocket）不匹配、协议不一致、权限不足或容器网络未对齐，需严格核对配置并验证连通性。
-
必须显式设置CURLOPT_URL并调用curl_exec()，否则静默失败返回false；需设CURLOPT_RETURNTRANSFER=true获取响应体；用完必须curl_close()防文件描述符耗尽；HTTPS需处理SSL验证。
-
安装PHP安全防护插件可有效防御恶意请求与文件上传，提升服务器安全性。一、Suhosin通过强化PHP内核防止代码注入等攻击，需安装php-suhosin扩展并启用suhosin.so，重启Web服务生效；二、ModSecurity作为WAF可实时监控HTTP流量，安装libapache2-mod-security2模块后启用security2，修改SecRuleEngine为On并导入OWASPCRS规则集；三、PHPIDS为轻量级运行时检测库，识别XSS与SQL注入，需克隆项目至include目录，配
-
PHP8.3的#[\Override]属性是编译期强制校验机制，标记后即严格检查父类或接口中是否存在同名且签名匹配的方法，方法名拼错、参数/返回类型不兼容、访问修饰符更严格、覆盖不可继承方法等均触发Fatalerror。
-
用好Doctrine参数绑定和输出时强制转义可基本防御SQL注入与XSS；参数绑定须覆盖DQL、QueryBuilder和原生SQL所有场景，不可拼接用户输入；非参数化部分如字段名、排序方向、IN列表等需白名单校验与类型强转；Twig默认转义防HTMLXSS，但JS上下文须用|json_encode|raw，富文本需HTMLPurifier过滤；数据库权限、错误提示、路由约束、验证层等配置层面同样关键。
-
Packagist不支持直接筛选PHP7.4兼容包，需通过包页面的require.php字段确认（如"^7.2||^8.0"含7.4即兼容），或用composershowvendor/package查看各版本具体约束；搜索时可加php74等关键词初筛，但必须结合Packagist页面或show命令二次验证，避免依赖声明与实际语法/子依赖不一致。
-
PHP集成AI的关键是结构化Prompt设计，需包含角色、背景、任务、格式、约束五要素，并通过清洗截断、脱敏替换、变量校验保障安全拼接，辅以锚点标记与JSONSchema验证确保输出稳定可解析。
-
短信定时发送必须由服务端实现，因前端无法持久运行且无权直连运营商网关；推荐方案为Linux+crontab调用Python短信脚本，或进阶使用APScheduler/Celery实现任务持久化、重试与监控。
-
__destruct()在对象被垃圾回收判定为不可达时触发，非unset()立即执行，也非仅脚本结束才运行；其时机由引用计数归零与GC周期共同决定，可能延迟或不执行。
-
并发日志需确保上下文隔离与事务一致性：Log::info()无请求上下文故查不到用户ID；IP应取REMOTE_ADDR；用户ID仅在auth()->check()为true时提取；审计日志须afterCommit()保障事务提交后写入；索引需强制BTREE并按月分表；登录日志应放AuthenticatedSessionController@store末尾。
-
PHP协程需依赖Swoole，PHP8.1+的Fibers仅为底层原语，不支持自动IO挂起；业务级高并发协程唯一可靠方案是Swoole，其已协程化curl、MySQL、Redis等常用扩展，并默认启用。
-
PHP实现ETL的关键在于Hyperf环境下使用flow-php/etl：它不阻塞协程、支持多源混洗、内置RFC4180兼容的CSV解析（自动处理逗号/换行/双引号转义），但需确保UTF-8无BOM、正确配置enclosure/escape、显式启用空行保留，并对敏感字段清洗做到合规可溯。
-
Workerman跑稳百万级并发需同步调优Linux内核：net.core.somaxconn与tcp_max_syn_backlog必须同设为65535，fs.file-max设为2097152，ulimit-n与Worker::$defaultListenBacklog均匹配该值，并启用event扩展确保epoll生效，同时开启tcp_tw_reuse、关闭已弃用的tcp_tw_recycle。
-
应使用file_put_contents($path,$line."\n",FILE_APPEND|LOCK_EX)配合绝对路径、权限预配置和磁盘空间检查，失败时通过error_log兜底；高频场景需缓冲写入，避免SD卡磨损与阻塞。
