无法通过Composer创建Yii2项目（Ubuntu 16.04 LTS环境）

嘿，我来帮你搞定这个问题！你在Ubuntu 16.04 LTS上用Composer搭建Yii2项目，之前解决了php-mbstring缺失的问题，但现在新项目文件不全、浏览器打开还不正常，结合你提到的报错细节，咱们一步步排查解决：

先明确问题根源 #

从你的情况来看，项目不完整大概率是安装过程中依赖没装全、缓存干扰，或者权限配置不对；浏览器无法正常显示则可能是PHP扩展缺失、权限不足，或者核心文件未完整下载导致的。

针对性解决方案 #

1. 补全Yii2必需的PHP扩展 #

Yii2不止需要mbstring，还有一堆核心扩展得装上，不然依赖安装会失败，项目自然不全。执行下面的命令一次性装齐：

sudo apt-get update
sudo apt-get install php-xml php-zip php-intl php-mysql php-curl php-gd

装完记得重启Web服务，不然扩展不会生效：

# Apache用户执行
sudo service apache2 restart
# Nginx用户执行
sudo service nginx restart

2. 清除Composer缓存，重新完整安装项目 #

之前的安装可能因为中断或者缓存脏了导致文件不全，先清缓存再重新安装：

# 清除Composer本地缓存
composer clear-cache
# 重新创建基础版Yii2项目（把my-yii2-project换成你想要的项目名）
composer create-project --prefer-dist yiisoft/yii2-app-basic my-yii2-project
# 如果是高级版项目，用这条命令
composer create-project --prefer-dist yiisoft/yii2-app-advanced my-yii2-project-advanced

⚠️ 注意：别用sudo运行Composer，容易搞乱权限！如果目录没有写入权限，先修改目录所属：

sudo chown -R $USER:$USER /path/to/your/project/folder

3. 修复Yii2关键目录的权限 #

Yii2的runtime和web/assets目录需要Web服务器能写入，不然会报错甚至出现空白页。进入项目目录后执行：

cd /path/to/your/yii2-project
sudo chmod -R 775 runtime web/assets
sudo chown -R www-data:www-data runtime web/assets

这里www-data是Apache/Nginx默认的运行用户，如果你换了其他用户，记得替换成对应的用户组。

4. 排查PHP错误日志，揪出隐藏问题 #

浏览器空白页很多时候是PHP报错但没显示，咱们直接查看日志：

# 查看Apache错误日志
tail -f /var/log/apache2/error.log
# 查看Nginx错误日志
tail -f /var/log/nginx/error.log

也可以临时在项目根目录的web/index.php开头加几行代码，强制显示错误：

ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

这样浏览器会直接显示错误信息，方便精准定位问题。

5. 更新Composer到最新版本 #

Ubuntu 16.04自带的Composer版本可能太老，和Yii2的新依赖不兼容，更新一下：

sudo composer self-update

验证是否解决 #

做完上面的步骤后，访问你的项目地址（基础版是http://你的域名/项目目录/web），如果能看到Yii2的蓝色欢迎页面，那就搞定啦！

内容的提问来源于stack exchange，提问作者Yousuf Khan