在开始 Laravel 开发之前,首先需要设置一个适合的开发环境。Laravel 是基于 PHP 的框架,因此你需要一些基础的开发工具和环境配置。下面是详细的 Laravel 开发环境设置 教程,帮助你快速开始开发。
1. 安装 Composer
Laravel 依赖于 Composer,这是一个 PHP 的依赖管理工具。首先,确保你安装了 Composer。
安装 Composer
- Windows: 访问 Composer 官网 下载并安装。
- macOS / Linux:
打开终端并运行以下命令:
curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer
安装完成后,你可以通过以下命令检查 Composer 是否安装成功:
composer --version
2. 安装 PHP 环境
Laravel 需要 PHP 7.4 或更高版本。如果你已经安装了 PHP,可以通过以下命令检查 PHP 版本:
php -v
如果没有安装 PHP,你可以按照操作系统的要求安装:
brew install php
- Linux:
通过包管理器安装 PHP。例如,在 Ubuntu 上:
sudo apt update
sudo apt install php php-cli php-fpm php-mbstring php-xml php-curl
3. 安装数据库
Laravel 支持多种数据库,包括 MySQL、PostgreSQL、SQLite 和 SQL Server。根据你需要的数据库进行安装。
- MySQL:
- Windows: 安装 XAMPP 或 MySQL Installer.
- macOS: 使用 Homebrew 安装:
bash brew install mysql - Linux:
sudo apt update sudo apt install mysql-server - SQLite: Laravel 默认支持 SQLite,所以无需额外安装数据库,只需要确保
php-sqlite3扩展已启用。
4. 配置开发环境
Laravel 开发过程中,最常用的工具是 Homestead 和 Valet,这两个工具简化了开发环境的设置。
4.1 使用 Laravel Homestead
Laravel Homestead 是一个官方的 Vagrant 开发环境,提供了虚拟化的开发环境,适用于 Windows 和 macOS 用户,Linux 用户可以直接使用本机环境。
- 安装 Vagrant 和 VirtualBox(Homestead 依赖这些工具):
- Vagrant 下载
- VirtualBox 下载
- 安装 Homestead
vagrant box add laravel/homestead
- 初始化 Homestead
vagrant init laravel/homestead
- 配置 Homestead:修改
Homestead.yaml配置文件,设置共享文件夹和虚拟机的端口。
4.2 使用 Laravel Valet
如果你是 macOS 用户,Laravel Valet 提供了一个简单快速的开发环境,它通过将你机器上的本地开发项目绑定到 .test 域名来工作。
- 安装 Valet:
composer global require laravel/valet
valet install
- 在你本地的工作目录中创建一个 Laravel 项目并启用 Valet:
cd ~/Sites
valet park
- 创建一个新的 Laravel 项目:
composer create-project --prefer-dist laravel/laravel blog
- 在浏览器中访问项目:
访问http://blog.test。
5. 安装 Laravel
现在你已经安装好了 PHP 和数据库环境,接下来安装 Laravel。你可以选择通过 Composer 来全局安装 Laravel 或者直接创建新项目。
5.1 安装 Laravel 通过 Composer
使用以下命令来创建一个新的 Laravel 项目:
composer create-project --prefer-dist laravel/laravel your-project-name
5.2 安装 Laravel 使用 Laravel Installer(可选)
如果你安装了 Laravel Installer,可以使用以下命令来创建新项目:
composer global require laravel/installer
laravel new your-project-name
确保将 Composer 的 bin 目录添加到系统的 PATH 环境变量中。你可以在命令行中运行 laravel 命令来创建新的项目。
6. 配置 .env 文件
Laravel 使用 .env 文件来管理环境变量。这个文件在项目根目录下,包含了数据库配置、应用密钥、调试模式等信息。常见配置如下:
APP_NAME=Laravel
APP_ENV=local
APP_KEY=base64:yourkeyhere
APP_DEBUG=true
APP_URL=http://localhost
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=
确保根据你的开发环境修改 .env 文件中的配置,特别是数据库连接信息。
7. 运行开发服务器
安装完 Laravel 后,你可以通过 Laravel 提供的 Artisan 命令来启动开发服务器。
php artisan serve
默认情况下,Laravel 的开发服务器将运行在 http://localhost:8000。
8. 结语
设置 Laravel 开发环境通常涉及安装 PHP、Composer、数据库、开发工具(如 Homestead 或 Valet)等。通过这些步骤,你可以快速地搭建一个 Laravel 项目并开始开发。