-
在phpEnv中关闭Nginx版本号，需在nginx.conf的http块内添加server_tokensoff;并执行./nginx-sreload（Linux/macOS）或nginx-sreload（Windows），同时检查sites-enabled/等include文件中无冲突配置，并同步设置expose_php=Off以隐藏PHP版本。
-
Yii伪静态在Apache下失效的主因是三处未配齐：Apache需启用mod_rewrite并设AllowOverrideAll，urlManager须同时配置enablePrettyUrl=>true、showScriptName=>false及非空rules，.htaccess必须含RewriteEngineon及两条!-f/!-d条件和RewriteRule.index.php。
-
必须在index.php最开头定义ENVIRONMENT常量，值仅限'development'、'testing'或'production'；其他值如'staging'视为'production'，且晚于框架加载的定义无效。
-
Symfony项目在Caddy下404的根本原因是Caddy默认不隐式兜底未匹配路径到index.php，需显式配置重写规则将非静态文件请求全部rewrite至/index.php，否则路由无法被Symfony路由器解析。
-
多主表实为应用层字段拆分与冗余存储，非数据库标准术语；适用于高频查询、低频更新、跨库JOIN不可行及多服务分治场景，但需警惕DDL维护、数据一致性与迁移风险。
-
负载均衡必须与后端服务器同地域；阿里云内网型SLB严格限制同地域，公网型CLB跨地域需额外开通跨VPC能力，健康检查失败多因地域或可用区不匹配。
-
PHP8构造器属性提升可省去属性声明、类型提示和手动赋值三处重复代码。它要求参数必须带可见性修饰符、类型声明且名称一致，一行即完成属性定义与初始化，避免遗漏赋值，提升可维护性与类型推导准确性。
-
必须关闭宝塔所有自动CDN功能：删除反向代理规则、关闭非“强制HTTPS”的CDN选项、禁用防火墙中CDN回源白名单同步；CloudflareDNS需橙色云朵且A记录指向服务器公网IP；宝塔配置须保留原始Host头、禁用多余跳转，并确保Nginx正确解析X-Forwarded-For获取真实IP。
-
必须修改php.ini中session.save_path为绝对路径并赋予权限，如session.save_path="C:\phpEnv\sessions"，同时确保IIS_IUSRS或SYSTEM用户有写入权限，重启PHP进程后生效。
-
User实体必须显式指定connection，如@ORM\Entity(connection="auth_db")；自定义UserProvider需注入对应EntityManager并手动查询多库；角色表须与User同库，否则需改用非JOIN方式加载。
-
phpEnv不能直接安装ZooKeeper，它仅管理PHP版本与扩展；使用ZooKeeper需单独部署服务端并编译启用zookeeper.so扩展，且二者缺一不可。
-
DomPDF和Snappy生成PDF失败主因是字体配置、路径权限、子进程执行及HTML上下文隔离问题；需注册中文字体、绝对化资源路径、确认wkhtmltopdf路径与权限、校验PDF内容非空。
-
宝塔「强制HTTPS」失效主因是SSL证书未真正启用或Nginx未监听80端口；需确认证书状态为“已启用”且有效期正常，同时确保Nginx监听80端口并正确配置跳转规则与混合内容处理。
-
orderBy仅作用于主表字段，动态排序须白名单校验，关联字段排序需join或withCount，ID置顶用orderByRaw；firstWhere不参与排序。
-
安装路径不能含中文或空格，否则phpenv命令会失效；Windows用户应装到纯英文无空格路径如D:\phpenv，Linux/macOS需注意家目录权限及shell配置文件正确写入与重载。
