yii 1.1项目从windows迁移到linux不能直接运行，需处理php扩展（mbstring、gd、pdo_mysql等）、大小写敏感路径、nginx/apache重写规则（script_filename必须用$document_root）、runtime目录权限（chown+chmod 755）以及时区与数据库charset显式配置。
将Yii 1.1框架项目从Windows本地开发环境迁移到Linux生产服务器，不是复制文件夹就能运行的事——路径大小写敏感、PHP扩展缺失、时区配置错位、Web服务器重写规则缺失，任一环节出错都会导致白屏、404或数据库连接失败。
检查PHP版本与必需扩展
Yii 1.1最低要求PHP 5.1.0，但实际部署必须用PHP 7.4或8.1（兼容性最佳），且以下扩展【必须启用】：mbstring、gd、pdo_mysql（或pdo_pgsql）、openssl、json、ctype、xml。Windows下用XAMPP/PHPStudy可能默认开启部分扩展，Linux上需手动确认：
执行php -m | grep -E "mbstring|gd|pdo|openssl"，缺哪个就装哪个。Ubuntu/Debian用sudo apt install php-mbstring php-gd php-mysql php-xml php-curl；CentOS/RHEL用sudo yum install php-mbstring php-gd php-mysqlnd php-xml php-curl。
特别注意：【pdo_mysql和mysql扩展不能共存】，Yii 1.1使用PDO，若系统同时加载了过时的mysql.so（非mysqli），会导致连接失败且报错极隐晦。
处理大小写敏感与文件路径
Windows不区分文件名大小写，Linux严格区分。常见故障点：
① 类文件命名：如控制器文件名为SiteController.php，但代码中写成siteController.php或Sitecontroller.php，Linux下直接抛出“Class not found”。
② 视图路径引用：在render()中写$this->render('index')，对应视图文件必须是views/site/index.php（小写site），若误建为Views/Site/Index.php，Linux拒绝加载。
③ 配置文件引入：检查index.php中require_once路径，避免混用protected/config/main.php和PROTECTED/CONFIG/MAIN.PHP这类写法。
这一步操作起来很简单，直接在Linux服务器上执行find . -name "*.php" | xargs grep -l "SiteController\|siteController"，快速定位命名不一致的文件。
重写规则适配Apache或Nginx
Yii 1.1依赖URL重写隐藏index.php，Windows本地常用Apache，但Linux生产环境多用Nginx——规则完全不同。
方法一：Apache（.htaccess已存在时）
确认mod_rewrite已启用：a2enmod rewrite → 重启Apache。确保AllowOverride All在虚拟主机配置中生效，否则.htaccess被忽略。
方法二：Nginx（无.htaccess支持）
PyCharm 2026.2.0.1 Linux版提供 JetBrains 官方 2026.2.0.1 版本安装包，适合需要指定 PyCharm 版本进行 Python 项目开发、运行和调试的用户。
在server块中加入：
location / {<br> try_files $uri $uri/ /index.php?$args;<br>}
location ~ \.php$ {<br> include fastcgi_params;<br> fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;<br> fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;<br>}
【关键】SCRIPT_FILENAME必须用$document_root而非$realpath_root，Yii 1.1的CHttpRequest依赖此变量解析脚本路径，填错会导致$_SERVER['SCRIPT_NAME']为空，路由完全失效。
权限与运行用户校准
Yii 1.1的runtime目录（含logs、cache、assets子目录）必须可写，但不能开放777权限：
执行sudo chown -R www-data:www-data runtime（Ubuntu/Debian）或sudo chown -R apache:apache runtime（CentOS），再执行chmod -R 755 runtime。
注意：【不要递归chmod 777】，某些共享主机因安全策略会拒绝执行含world-writable的PHP脚本，直接返回500错误。
验证方式：访问/index.php?r=site/test（假设存在该action），观察runtime/logs/app.log是否生成新日志行。
时区与数据库连接参数显式声明
Windows注册表常设时区为“中国标准时间”，Linux默认可能为UTC或未设置，导致date()、CDateTimeParser解析出错：
在index.php顶部添加：date_default_timezone_set('Asia/Shanghai');，比在php.ini里改更可靠，避免不同环境php.ini路径不一致。
数据库连接字符串中，务必显式指定charset：
'connectionString' => 'mysql:host=localhost;dbname=yiiapp;charset=utf8',
MySQL 5.5+默认字符集已是utf8mb4，但Yii 1.1的PDO驱动若不声明charset，可能用latin1连接，造成中文乱码或插入失败。
