PHP脚本调用require_once()加载类时终止问题求助
作为刚碰PHP就接盘遗留项目、还要Docker化的人，这种摸黑踩坑的感觉我太懂了！你遇到的脚本在require_once加载类时无声终止的问题，大概率是环境不兼容或者配置没跟上，给你几个一步步排查的方向：
1. 先把错误显示开起来！
这是最关键的第一步——Docker环境里PHP默认经常把错误给藏起来，脚本死了你根本不知道为啥。直接在项目入口文件（比如根目录的index.php）最顶部加几行代码：
error_reporting(E_ALL); ini_set('display_errors', 1); ini_set('display_startup_errors', 1);
或者在你的Docker镜像里修改php.ini配置这几个参数，确保能看到所有错误信息，不然全靠猜太折磨人。
2. 排查PHP版本兼容性
CodeIgniter不同版本对PHP版本要求差很多：
- CodeIgniter 1.x 适配 PHP 5.2+
- 2.x 适配 PHP 5.2 ~ 7.4
- 3.x 适配 PHP 5.6 ~ 8.1
- 4.x 要求 PHP 7.4+
你先看看项目里的CodeIgniter版本（看system/core/CodeIgniter.php里的版本注释），然后Docker镜像就选对应的PHP版本，比如老项目大概率用的是PHP 7.4及以下，别上来就用PHP 8.x，很多旧语法（比如用类名当构造函数、旧的mysql扩展）在新版本里直接报错终止。
3. 检查文件权限问题
Docker容器里的文件默认可能是root权限，但PHP-FPM或Apache的运行用户是www-data，如果require_once要加载的文件没读权限，脚本会直接终止，而且可能不报错（没开错误显示的话）。
解决方法：在Dockerfile里加权限配置：
# 把项目目录的所有者改成www-data RUN chown -R www-data:www-data /var/www/html # 设置合理的读写权限 RUN chmod -R 755 /var/www/html
或者启动容器时指定用www-data用户运行：docker run -u www-data ...
4. 核对CodeIgniter的路径配置
CodeIgniter对路径很敏感，Docker环境里的工作目录可能和原服务器不一样，导致加载路径出错：
- 打开
application/config/config.php，检查$config['base_url']，要改成Docker容器能访问的地址，比如http://localhost:8080（对应你映射的端口） - 看
require_once的路径写法，如果是相对路径（比如require_once('application/libraries/MyClass.php')），改成用CodeIgniter内置的常量，比如require_once(APPPATH.'libraries/MyClass.php')，APPPATH是框架已经定义好的绝对路径，不会出错。
5. 检查PHP扩展是否缺失
遗留项目大概率依赖一些PHP扩展，比如CodeIgniter的数据库功能需要pdo_mysql或mysql扩展，还有mbstring、curl这些常用扩展没装的话，加载类时因为依赖缺失会直接终止。
在Dockerfile里安装需要的扩展，比如针对PHP 7.4：
RUN docker-php-ext-install pdo_mysql mbstring curl
如果是更老的PHP 5.6，要装mysql扩展而不是pdo_mysql：
RUN docker-php-ext-install mysql mbstring curl
额外小提示
调试时别只看类声明行，看看类的构造函数或者初始化代码里有没有操作数据库、调用其他依赖的逻辑——比如数据库配置不对（Docker里数据库地址是容器名而不是localhost），也会导致脚本在加载类后终止，开了错误显示就能一眼看到。
一步步来，先搞定错误显示，再逐个排除版本、权限、扩展这些问题，很快就能找到根源！
内容的提问来源于stack exchange，提问作者Braden
