Laravel框架安装与本地环境配置详细教程

Laravel 安装配置全攻略：手把手教你搭建本地开发环境

在开始 Laravel 项目开发前，请确保已安装 PHP 8.1 或更高版本，并启用 mbstring、openssl、pdo_mysql、fileinfo、xml 等核心扩展。同时，建议将 Composer 镜像源配置为阿里云，以加速依赖包下载。启动开发服务器前，请确认位于项目根目录、端口未被占用，并已执行 php artisan key:generate 生成应用密钥。

搭建 Laravel 本地开发环境是项目成功的第一步。如果 PHP 和 Composer 这两大基石未能正确安装与配置，后续所有开发步骤都将受阻——这也是许多初学者入门时遇到的首要难题。

第一步：验证 PHP 环境与必备扩展

Laravel 10 及以上版本对运行环境有严格要求：PHP 版本需不低于 8.1，且必须启用 mbstring、openssl、pdo_mysql、fileinfo、xml 等核心扩展。仅通过 php -v 查看版本是不够的，建议运行以下命令检查扩展是否已加载：

php -m | grep -E "(mbstring|openssl|pdo_mysql|fileinfo|xml)"

若输出结果中缺少某个扩展，则表明其未启用。Windows 用户通常需编辑 php.ini 文件，取消对应 extension=xxx 行的注释。对于使用 Homebrew 安装 PHP 的 macOS 或 Linux 用户，执行 brew install php@8.2 后扩展通常已包含，但需注意系统默认 php 命令可能与 Homebrew 版本冲突。此时，使用 which php 确认命令路径是一个好习惯。

第二步：配置 Composer 国内镜像加速依赖安装

未配置镜像源时，执行 composer create-project 拉取依赖极易因网络问题导致超时或卡顿。只需一条命令即可配置阿里云镜像，大幅提升下载速度：

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

配置完成后，可通过以下命令验证是否生效：

composer config -g repo.packagist

终端应输出 https://mirrors.aliyun.com/composer/。此配置为全局设置，不影响现有项目，但能显著提升新建项目的依赖下载效率。若因网络问题卡住，可按 Ctrl+C 中断，配置镜像源后重试即可。

第三步：解决 php artisan serve 启动常见问题

启动 Laravel 开发服务器时，若遇到 Could not open input file: artisan 错误，通常有两个原因：一是当前终端目录非项目根目录（找不到 artisan 文件）；二是在 Linux/macOS 下，用户对 artisan 文件缺少执行权限（较少见）。

另一常见错误是 Address already in use

• php artisan serve --port=8001
• php artisan serve --host=127.0.0.1 --port=8080

php artisan key:generate

mysql -u root -h 127.0.0.1 -P 3306 -D laravel_site