Laravel开发 Mac环境 mac laravel_None环境配置与常见问题解决方法

本文目录导读：

1. 🛠️ 环境配置步骤
2. 🔥 常见问题 & 解决方案
3. 💡 Mac专属小技巧

🚀 Mac环境Laravel开发配置指南（2025.08更新）

🛠️ 环境配置步骤

1. 安装Homebrew（包管理神器）

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

   小贴士：喝杯咖啡☕，等待安装完成~

   

2. PHP 8.3+ 安装（Laravel 10+ 要求）

   brew install php@8.3
   echo 'export PATH="/opt/homebrew/opt/php@8.3/bin:$PATH"' >> ~/.zshrc
   source ~/.zshrc

   验证：php -v 显示版本即成功✨

3. Composer 全球安装

   brew install composer
   composer global require laravel/installer

   路径配置：echo 'export PATH="$HOME/.composer/vendor/bin:$PATH"' >> ~/.zshrc

4. 数据库选择（任选其一）

   

   • MySQL 8.0：brew install mysql && brew services start mysql
   • PostgreSQL 16：brew install postgresql && brew services start postgresql
     💡 推荐用Sequel Ace可视化工具管理数据库

5. 创建Laravel项目

   laravel new myapp && cd myapp
   php artisan serve

   浏览器访问 http://localhost:8000 看到🦄即成功！

🔥 常见问题 & 解决方案

1. Class 'PDO' not found 错误
   💡 安装PHP PDO扩展：

   brew reinstall php@8.3 --with-pdo-mysql

2. Permission denied 无法创建 .env
   🔧 修改目录权限：

   chmod -R 775 storage bootstrap/cache

3. Composer 下载慢？
   🌐 换国内镜像（临时生效）：

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

4. Valet 无法启动？
   🛑 重装Valet并信任证书：

   composer global require laravel/valet
   valet install --force

💡 Mac专属小技巧

• 快捷启动PHP服务：用 php artisan serve --port=8080 自定义端口🚪
• 自动补全命令：在 .zshrc 添加 source $(laravel completion zsh)
• Docker替代数据库：用 docker run -e MYSQL_ROOT_PASSWORD=root -p 3306:3306 mysql:8.0 快速启动🐳

📅 信息更新至2025年8月，兼容最新macOS Sonoma 15.0系统！