-
先确认扩展文件存在且路径正确，再检查PHP版本与扩展兼容性、系统依赖库完整性、php.ini启用语法规范，并区分CLI与WebSAPI配置文件。
-
无法直接阅读或修改加密PHP文件时，可依序识别加密类型、用ionCube工具解密、反混淆base64/gzinflate代码、动态调试捕获内存中解密内容、或反编译OPcache字节码。
-
80端口被PID为4占用时，不可用taskkill强杀，须停用IIS、SQLServerReportingServices等上层服务或修改Apache端口为8080。
-
Nginx需显式配置禁止访问.git等敏感目录，最简方式为location~/\.{denyall;}，应置于server块顶层且在PHP处理规则之前，防止源码泄露。
-
Webman默认不启用自动依赖注入，需显式配置php-di；闭包路由、手动new实例、PHP8+非空类型属性三类场景最易触发注入失败或Typedpropertymustnotbeaccessedbeforeinitialization报错。
-
Nginx缓存在phpEnv中默认关闭且无proxy_cache模块支持；需先验证with-http_proxy_module是否存在，否则只能启用浏览器端expires/Cache-Control缓存，或替换为完整版Nginx并手动配置proxy_cache_path与proxy_cache指令。
-
Doctrine实体关系映射需确保配置、映射与查询三层咬合：多对多须显式预加载；继承映射需yaml类型匹配attribute、基类标注InheritanceType与DiscriminatorColumn；APIPlatform子类须独立标注ApiResource；带排序字段的中间表须改用OneToMany关联中间实体。
-
直接重命名.c为.php无法运行，因C与PHP语法、内存模型、执行机制完全不兼容；必须重写逻辑，将C功能用PHP重新实现，并适配输入输出、数据结构、系统调用等差异。
-
最直接安全的方式是用(string)强制类型转换，它不修改原变量、无精度丢失、语义清晰；strval()有函数调用开销且可读性弱；字符串拼接和json_encode等场景需显式转换，格式化需求须用sprintf等专用函数。
-
influxdata/influxdb-client-php已停更且不支持InfluxDB2.x完整功能，推荐直接调用HTTPAPI：写入用/api/v2/write（带org/bucket参数和Token认证），查询用/api/v2/query（传Flux脚本），时间戳须为纳秒整数。
-
数据库迁移是用PHP代码描述表结构变更，通过up()和down()方法实现可重复、可回退、跨环境执行；必须新建迁移处理变更，禁止修改已执行文件；migrate按时间戳顺序执行并记录批次，rollback按批回退，fresh会清空重跑但生产禁用。
-
应使用原生DB事务、重载JSON访问器、显式赋值触发更新或调整隔离级别与加锁。具体包括：一、用DB::transaction配合json_set或完整JSON字符串更新；二、重载setJsonAttribute并清除脏状态；三、通过casts配置后显式重新赋值JSON字段；四、降低隔离级别至READCOMMITTED或行锁+完整替换+json_encode校验。
-
必须将character_set_server改为utf8mb4并重启MySQL服务，再逐库逐表执行ALTERDATABASE和ALTERTABLECONVERTTOutf8mb4，导出时还需指定--default-character-set=utf8mb4参数，否则旧数据仍乱码。
-
Calendar扩展在phpEnv中默认未启用，需选用含该模块的完整版PHP包（如标注full或all的版本），取消php.ini中extension=calendar注释并重启服务；Windows下无独立DLL，不可下载加载。
-
PHP动态拼接查询条件应使用预处理+条件数组，避免SQL注入；通过$where和$params分别收集条件与参数，支持空值过滤、时间范围、IN列表等；封装buildWhereClause函数提升复用性；分页排序需白名单校验字段并绑定参数。
