在Linux服务器上部署CodeIgniter框架，核心在于确保Web服务器支持PHP 7.3以上版本，正确设置目录权限（尤其是writable和uploads），并启用URL重写模块来消除index.php。 这是官方文档和社区经验反复验证的基础步骤，如果遇到页面空白或404错误，优先排查这三项，可以解决80%以上的问题。
CodeIgniter Linux 环境配置要点
PHP版本选择与扩展安装
CodeIgniter 4要求PHP 7.3以上，目前推荐使用PHP 8.1，因为它在性能和安全上更成熟，据PHP官方统计，超过60%的PHP应用已迁移至8.x系列，安装时，确保以下扩展已启用：mbstring、intl、curl、json、gd、mysql，在Debian/Ubuntu系统上，使用命令：
sudo apt-get install php8.1 php8.1-mbstring php8.1-intl php8.1-curl php8.1-gd php8.1-mysql对于CodeIgniter 3，PHP 5.6以上即可，但已不推荐使用低版本，行业共识认为，生产环境至少应使用PHP 7.4，以获取安全更新。
Web服务器配置：Apache与Nginx
Apache：安装后启用mod_rewrite，设置虚拟主机AllowOverride All，并在项目根目录放置.htaccess文件，CodeIgniter官方提供的重写规则可以直接复制，关键行是：
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.)$ index.php/$1 [L]Nginx：需要在server块中添加伪静态规则，这是最常见的配置场景，也是很多开发者搜索codeigniter linux nginx的原因，配置如下：
location / {
try_files $uri $uri/ /index.php?$query_string;
}注意：CodeIgniter 4的根目录是public，所以root指向项目下的public文件夹，如果使用宝塔面板，可以快速选择内置的CodeIgniter伪静态规则，但需要手动确认PHP版本是否匹配，这是codeigniter linux 宝塔配置中容易忽略的一点。
目录权限与安全设置
CodeIgniter 4的writable目录需要可写权限，推荐使用：
sudo chown -R www-data:www-data /var/www/project
sudo chmod 755 /var/www/project/writable对于CodeIgniter 3，需设置application/cache、application/logs等目录可写，避免使用777权限，应使用775并指定所属用户组，数据库配置在.env文件中完成，注意数据库主机在Linux上通常使用localhost或127.0.0.1，远程连接需确认网络策略。
CodeIgniter Linux 部署实战
从本地推送到服务器
部署流程直接影响上线效率,首先使用Git拉取代码到服务器，然后运行composer install –no-dev，仅安装生产环境依赖，这是避免调试代码泄露的关键步骤。
git clone git@github.com:yourrepo.git /var/www/project
cd /var/www/project
composer install --no-dev接着复制.env.example为.env，逐项配置数据库、缓存、环境模式，对于CodeIgniter 4，运行数据库迁移：
php spark migrate最后设置目录权限,配置Web服务器指向public目录，重启服务后测试访问。
迁移中的坑与应对
从Windows迁移到Linux时,最常见的问题是文件大小写，Linux文件系统对大小写敏感，控制器文件名必须与类名大小写完全一致，BlogController.php中定义class BlogController，文件名必须大写B和C，另一个问题是路径分隔符，在代码中应使用正斜杠或DIRECTORY_CONSTANT。
数据库迁移同样需要注意字符集,导出时使用UTF-8，导入前确认数据库和表的排序规则为utf8mb4_general_ci，如果使用远程数据库，需要检查防火墙规则，确保服务器能连接到数据库端口（如3306）。
CodeIgniter Linux 性能优化方案
启用OPcache与缓存层
PHP代码的编译缓存是提升性能的直接手段,在php.ini中设置：
opcache.enable=1 opcache.memory_consumption=128 opcache.max_accelerated_files=4000 opcache.revalidate_freq=60
这样可以将PHP脚本的编译结果缓存到内存中,减少重复编译，配合CodeIgniter自带的缓存功能，效果更明显，在app/Config/Cache.php中，将驱动改为Redis或Memcached，并设置过期时间。
数据库查询优化
查询构造器（Query Builder）是CodeIgniter的优势，但不当使用会导致性能下降，避免在循环中执行SQL，使用批量插入或子查询，为常用字段添加索引，尤其是where条件涉及到的列，在Linux上，可以使用mysqltuner工具分析数据库性能，并给出调优建议。
静态资源与Gzip压缩
使用CDN加速静态资源,或者在Nginx中配置gzip压缩：
gzip on;
gzip_types text/plain text/css application/json application/javascript text/xml;这能显著减少传输体积,提升页面加载速度，对于高并发场景，还可以使用Linux的Swap分区，但这不是CodeIgniter特有的优化，而是服务器层面的补充。
常见问题与排查：CodeIgniter Linux 部署中的坑
500错误与空白页
出现500错误时,首先查看application/logs目录下的日志文件，CodeIgniter的日志记录了具体错误信息，包括PHP错误、数据库异常等，如果日志为空，检查目录权限是否正确，临时开启调试模式，在.env中设置CI_ENVIRONMENT=development，可以显示错误详情，但上线后务必关闭。
控制器404
如果路由无法匹配,检查URL大小写和控制器文件名，在Linux上，controller BlogController只能通过blog或Blog访问，具体取决于路由定义，确认重写规则是否生效，访问index.php/controller是否能正常打开，如果可以，说明重写未配置好。
数据库连接失败
在Linux上,数据库连接失败通常由三方面原因导致：.env中的数据库参数错误、MySQL服务未启动、网络防火墙阻止，使用命令mysql -u root -p -h localhost测试连接，排除数据库本身问题，如果使用远程数据库，需要确认数据库用户的host权限允许远程访问。
在Linux环境下使用CodeIgniter,只要遵循配置规范，注重权限和伪静态规则，就能获得稳定高效的运行环境，结合适当的缓存策略，可以应对中大型项目的需求，环境配置和部署的每一步都值得反复验证，这样才能避免生产环境中的意外问题。
CodeIgniter Linux 常见问题解答
Q1: CodeIgniter在Linux上访问显示404，如何解决？
首先确认Web服务器使用了正确的伪静态规则,对于Apache，检查mod_rewrite是否启用，.htaccess是否有效且内容正确；对于Nginx，检查location规则是否完整，并确保root指向的是public目录，然后确认默认控制器是否存在，文件名和类名大小写是否匹配，尝试访问index.php/controller，如果能正常打开，则问题出在重写规则上。
Q2: 如何将CodeIgniter项目从Windows迁移到Linux服务器？
迁移前,确保文件编码统一为UTF-8，使用Git上传代码，在Linux上运行composer install安装依赖，复制.env文件并修改数据库配置，注意Linux文件系统大小写敏感，需要检查控制器和模型文件名是否与类名一致，数据库导出时使用UTF-8，导入后检查字符集，最后设置目录权限，确保writable目录可写，并重启Web服务器。
Q3: CodeIgniter 4在Linux上推荐使用Nginx还是Apache？
两者都支持,但Nginx在高并发场景下性能更优，内存占用更低，配合PHP-FPM能处理更多请求，Apache的优势在于配置简单，通过.htaccess即可完成重写规则，适合小型项目，行业共识认为，生产环境推荐使用Nginx，尤其是需要处理大量并发时，如果团队熟悉Apache，也可以稳定运行，但需要注意性能监控和调优。
首发原创文章，作者：世雄 - 原生数据库架构专家，如若转载，请注明出处：https://idctop.com/article/503413.html
