为什么Debian装Laravel失败

Debian 上安装 Laravel “失败”是一个比较笼统的说法，常见原因通常集中在环境不满足、权限问题、网络/镜像问题这几类。下面按最常见失败原因 → 表现 → 解决办法给你梳理一下。

一、PHP 版本太低（最常见）

现象

composer create-project laravel/laravel demo

报错类似：

Your requirements could not be resolved
laravel/framework requires php ^8.1

原因

Debian 默认仓库里的 PHP 版本偏旧（如 Debian 11 是 PHP 7.4）。

解决

用 sury 仓库安装新 PHP：

sudo apt install -y lsb-release ca-certificates apt-transport-https software-properties-common
sudo wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg
sudo sh -c 'echo "deb https://packages.sury/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list'
sudo apt update
sudo apt install php8.2 php8.2-cli php8.2-common php8.2-mbstring php8.2-xml php8.2-curl php8.2-zip

二、Composer 没装或版本太旧

现象

composer: command not found

或

Composer 1.x 不支持 Laravel 10/11

解决

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
sudo mv composer.phar /usr/local/bin/composer
composer --version

三、扩展缺失

常见缺的扩展

mbstring
xml
curl
zip
bcmath
openssl

报错示例

The requested PHP extension ext-zip * is missing

解决

sudo apt install php8.2-mbstring php8.2-xml php8.2-curl php8.2-zip php8.2-bcmath

四、目录权限问题（安装成功但访问报错）

现象

页面空白
Permission denied
storage/logs/laravel.log

解决

sudo chown -R www-data:www-data /var/www/demo
sudo chmod -R 755 /var/www/demo
sudo chmod -R 775 storage bootstrap/cache

五、Web 服务器没配置（Apache / Nginx）

Apache 示例

sudo apt install apache2 libapache2-mod-php8.2

站点根目录指向：

/var/www/demo/public

Nginx 示例

root /var/www/demo/public;
index index.php;

六、网络 / 镜像问题（国内常见）

现象

Connection timed out
Could not resolve host

解决（国内）

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

七、最简单排查方式（建议你贴出来的信息）

如果你愿意，直接把完整报错信息贴出来，我可以精准判断，比如：

Composer 报错全文
php -v
composer -v
Debian 版本（cat /etc/os-release）

✅ 一句话总结

Debian 装 Laravel 失败，90% 是因为 PHP 版本旧、扩展不全或权限不对。

如果你愿意，告诉我：

Debian 版本 + 报错截图/文字
我可以直接帮你一步一步装成功。