Mac装CodeIgniter关键在于确保index.php被Web服务正确识别:需配置Apache/Nginx支持PHP执行与重写规则,base_url须动态生成避免硬编码,严格遵循大小写命名规范,并确保writable目录权限正确。

Mac 上装 CodeIgniter,核心就一条:别让 index.php 被系统或 Web 服务“看不见”。 macOS 自带 Apache(或你用 XAMPP/MAMP)默认不启用 PHP 模块、不处理重写规则、不自动识别 CI 的入口文件路径——这不是 CI 本身的问题,是环境链路断在了最前面。
Apache 或 Nginx 配置必须显式支持 index.php 入口
Mac 自带 Apache(/etc/apache2/)默认只把 index.html 当首页,index.php 会被忽略;Nginx 更严格,默认不执行 PHP 文件。不配好这一层,连欢迎页都出不来。
- Apache:确认
LoadModule php_module libexec/apache2/libphp.so已取消注释,且DirectoryIndex包含index.php - Nginx:必须在
location /块里加try_files $uri $uri/ /index.php?$query_string;,否则所有路由 404 - XAMPP 用户:直接把整个 CI 文件夹丢进
/Applications/XAMPP/xamppfiles/htdocs/即可,但要访问http://localhost/your-ci-folder/,不是http://localhost/—— 否则会撞上 XAMPP 自带首页
application/config/config.php 的 base_url 别硬写 localhost
CI 不靠域名推断路径,全靠这个配置生成资源链接(CSS/JS/图片)。写死 http://localhost 在 Mac 本地开发时看似能用,但一旦换端口、换虚拟主机、或用 ~username 路径(如 http://localhost/~yanzi/myapp),所有静态资源立刻 404。
- 推荐写法:
$config['base_url'] = 'http://'.$_SERVER['HTTP_HOST'].dirname($_SERVER['SCRIPT_NAME']).'/'; - 或者更稳:用
$_SERVER['DOCUMENT_ROOT']和当前脚本位置算出相对路径,再拼成 URL - 验证方法:在视图里输出
<?php echo base_url('css/app.css'); ?>,看浏览器 Network 标签里请求地址是否正确
文件权限和大小写敏感性在 Mac 上“假装宽容”,上线就炸
macOS 默认文件系统(APFS)对大小写不敏感,但绝大多数 Linux 服务器(包括阿里云、AWS)是严格区分大小写的。CI 的控制器类名、文件名、类内方法名,差一个大写就报 404 Not Found 或 Class not found。
- 控制器文件必须首字母大写:比如
Users.php,不是users.php;类名也必须是class Users extends CI_Controller - Mac 下用小写命名可能“跑得通”,但一上传到生产环境,
$this->load->model('user_model');就失败——因为实际文件是User_model.php - PHP 扩展权限也要检查:
application/和writable/(CI4)或application/logs/(CI3)目录需对 Web 进程可写,Mac 上常被误设为仅用户可写
真正卡住人的从来不是下载解压那一步,而是 Apache/Nginx 怎么把请求准确扔给 index.php、base_url 怎么不随环境失效、以及那些在 Mac 上“恰好能过”的大小写和权限问题——它们安静地躺在本地,等你第一次部署到服务器时集体发难。










