在 CentOS 上“装不了 Laravel”通常不是 Laravel 本身的问题,而是环境不满足或操作方式不对。下面按最常见原因给你梳理一下,基本能对号入座。
Laravel 对 PHP 版本要求很高:
| Laravel 版本 | 最低 PHP 版本 |
|---|---|
| Laravel 10 | PHP 8.1 |
| Laravel 11 | PHP 8.2 |
| Laravel 12 | PHP 8.2+ |
✅ 解决:
# 使用 Remi 源
yum install -y epel-release
yum install -y https://rpms.remirepo.net/enterprise/remi-release-7.rpm
yum install -y yum-utils
yum-config-manager --enable remi-php82
yum install -y php php-cli php-mbstring php-xml php-json php-zip
Laravel 必须用 Composer 安装。
检查:
composer -V
如果没有:
curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer
Laravel 需要:
mbstringopensslpdotokenizerxmlctypejson报错类似:
PHP Extension mbstring is missing
✅ 安装:
yum install php-mbstring php-xml php-json
常见错误:
failed to open stream: Permission denied
✅ 正确做法:
chown -R nginx:nginx /var/www/laravel
chmod -R 755 /var/www/laravel
chmod -R 777 storage bootstrap/cache
可能会直接失败或警告。
✅ 建议:
composer create-project laravel/laravel example-app
如果非 root:
sudo -u www composer install
报错看不懂时,先试:
setenforce 0
长期解决:
setsebool -P httpd_read_user_content 1
Composer 卡死、超时。
✅ 换国内镜像:
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/
php -v
composer -V
php -m | grep mbstring
都正常后:
composer create-project laravel/laravel test
如果你愿意,可以把具体报错信息贴出来(命令行报错最重要),我可以直接告诉你到底是哪一步卡住了。