debian装laravel失败怎么办

在 Debian 上安装 Laravel 失败，通常和 PHP 版本、依赖、权限、Composer 有关。下面按「最常见原因 → 解决步骤」给你一套排查方案。

一、先确认基础环境

1️⃣ 检查 PHP 是否安装

php -v

Laravel 10+ 需要 PHP 8.1+

如果没装或版本太低：

sudo apt update
sudo apt install php php-cli php-mbstring php-xml php-curl php-zip php-mysql unzip

2️⃣ 检查 Composer

composer -V

没装就装：

sudo apt install composer

或官方方式：

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

二、最常见失败原因 & 解决方案

❌ 1. PHP 扩展缺失

错误示例：

The requested PHP extension mbstring is missing

解决：

sudo apt install php-mbstring php-xml php-curl php-zip

然后：

sudo systemctl restart apache2   # 或 php-fpm

❌ 2. 内存不足（Composer 报错）

错误：

PHP Fatal error: Allowed memory size exhausted

解决：

php -d memory_limit=-1 composer create-project laravel/laravel demo

❌ 3. 权限问题（storage / bootstrap）

错误：

The stream or file could not be opened

解决：

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

❌ 4. 用 root 装 Composer 包被拒

错误：

Do not run Composer as root

解决（推荐）：

adduser deploy
su - deploy
composer create-project laravel/laravel demo

❌ 5. Debian 旧版 PHP 太低

Debian 11 默认 PHP 7.4 ❌
Laravel 10/11 不支持

解决：

sudo apt install lsb-release ca-certificates apt-transport-https
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.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list'
sudo apt update
sudo apt install php8.2 php8.2-cli

三、推荐的正确安装方式（Debian）

cd /var/www
composer create-project laravel/laravel demo
cd demo
php artisan key:generate

四、如果你愿意，我可以更精准帮你

你可以直接把 报错信息贴出来（终端完整错误），我可以：

精确判断是哪一步失败
告诉你具体该执行哪几条命令
帮你配 Nginx / Apache

你是 命令行安装失败，还是 浏览器访问 500？