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=8001php artisan serve --host=127.0.0.1 --port=8080.env 文件缺失或其中 APP_KEY 为空。此时服务器虽可能启动，但涉及会话、加密等功能时会出现异常。务必执行以下命令生成应用密钥：php artisan key:generate
.env 文件存在且 APP_KEY 为空时才会写入新密钥。第四步：数据库迁移前的环境检查与连通性测试
php artisan migrate 时若报错 SQLSTATE[HY000] [1045] Access denied，问题多出在 .env 中 DB_USERNAME 或 DB_PASSWORD 配置错误。例如，使用 Laragon 或 XAMPP 等集成环境时，MySQL root 用户默认密码常为空（不填写），而非“root”一词。mysql -u root -h 127.0.0.1 -P 3306 -D laravel_site
Access denied，则确认 .env 配置与 MySQL 实际设置不匹配。同时，请确保 DB_DATABASE 指定的数据库已存在，因为迁移命令仅创建数据表，不会自动创建数据库。APP_KEY 有一个重要细节：在本地环境生成一次即可。重复执行 key:generate 在本地虽无影响，却可能导致测试或生产环境密钥被意外轮换，引发混乱。此外，在推送代码至 Git 仓库前，务必确认 .env 文件未被提交，以避免敏感信息泄露的安全风险。
