-
快速定位Apache重写错误：重命名.htaccess后404消失即确认问题；查error.log中rewrite相关报错；最小测试法验证mod_rewrite是否启用及AllowOverride配置。
-
应修改Apache的DocumentRoot和Directory路径而非php.ini中的doc_root，因phpEnv使用模块或FPM模式使doc_root失效；需编辑vhosts.conf中VirtualHost段的两处路径并重启Apache验证。
-
根本原因是PDO实例持有失效socket且不自动重连，ThinkPHP的break_reconnect仅在PDO::ERRMODE_EXCEPTION开启且捕获到2002/2013/1040类错误时生效，事务中需全新启动而非复用上下文，Swoole等长连接场景须手动ping检测与重建。
-
宝塔报“磁盘已满”但df-h显示空间充足，大概率是inode耗尽或缓存未刷新；先运行df-h和df-i对比，若IUse%≥95%而空间使用率低，则聚焦/www/sess或/tmp下大量PHPsession小文件，用find统计并清理过期文件，再检查lsof|grepdeleted是否存在被占用的已删文件，必要时重启php-fpm。
-
PHP不画图，只输出结构正确、格式干净的JSON供ECharts使用；必须设置header('Content-Type:application/json;charset=utf-8')，确保UTF-8无BOM、字段名准确（如xAxis而非XAxis）、数值非字符串、无多余输出，否则前端报错或白屏。
-
Apache的ErrorDocument指令需写在httpd-multilang-errordoc.conf引入之后或禁用该模块，403需先确保目录权限（Requireallgranted）和LocationMatch规则未拦截，404/500页面须大于512字节、路径为根目录相对路径（如/404.html），且修改后必须重启Apache。
-
PHP获取客户端IP不能只依赖$_SERVER['REMOTE_ADDR']，因其在反向代理场景下返回代理内网IP；须结合可信代理列表校验X-Real-IP或X-Forwarded-For头中非私有/非保留的最右有效IP。
-
Laravel默认不直接支持MinIO，因其Storage门面依赖Flysystem，而官方S3驱动仅适配AWS签名逻辑与endpoint行为；MinIO虽兼容S3API，但需显式配置use_path_style_endpoint=>true、正确设置endpoint（无尾部斜杠）、并避免使用已废弃的aws-sdk-php-laravel包。
-
PHP防AI接口滥用需session+IP双重限频、JWT细粒度权限校验、UA/缓存头识别及异步日志告警，缺一环即失效。
-
PHP调用大模型API失败主因是鉴权头、请求体结构或响应字段解析错误；需严格设置Authorization和Content-Type头，用json_encode()传索引数组，按平台要求填动态modelID，并优先检查响应体error字段而非仅HTTP状态码。
-
本质是XAMPP未正确引入httpd-xampp.conf配置文件，导致PHP处理器未启用；需确认httpd.conf中Include"conf/extra/httpd-xampp.conf"未被注释，并检查该文件内SetHandlerapplication/x-httpd-php是否生效，同时排除端口占用及PHP配置路径错误。
-
PHPinterface不能实例化，必须由具体类实现后才能new；其方法仅允许public修饰符，禁止final/static/protected/private；多接口同名方法参数须完全兼容。
-
宝塔官方脚本在树莓派上大概率失败是因为默认不下载ARM64二进制包，需确保系统为aarch64架构、内核≥5.4，并推荐使用社区arm64专用脚本bt-arm.sh安装。
-
Widget::widget()必须传合法public属性，拼错名就静默丢弃；需显式传给render()；包裹内容须用begin()/end()；配置禁用闭包/对象；每次调用均为新实例。
-
“Noinputfilespecified”错误源于PHP-FPM未启用PATH_INFO、伪静态规则不匹配、PHP模式/配置错误或入口文件路径权限异常；需依次检查并配置fastcgi_paramPATH_INFO、选用正确伪静态规则、确认Nginx+PHP-FPM模式及cgi.fix_pathinfo=1、核验index.php存在性与权限。
