插件窝 干货文章 php laravel 开发环境搭建

php laravel 开发环境搭建

Laravel PHP 安装 Composer 724    来源:    2025-03-19

在开始使用 Laravel 进行开发之前,首先需要搭建一个适合的开发环境。Laravel 是一个基于 PHP 的 Web 应用框架,因此需要确保系统中安装了 PHP、Composer(PHP 的依赖管理工具)、以及一个数据库(如 MySQL)。以下是详细的步骤来搭建 Laravel 开发环境:

1. 安装 PHP

Laravel 需要 PHP 7.3 或更高版本。你可以通过以下命令检查 PHP 是否已经安装以及其版本:

php -v

如果没有安装 PHP 或者版本过低,可以通过以下方式安装:

  • Ubuntu/Debian:

    sudo apt update
    sudo apt install php php-cli php-fpm php-json php-common php-mysql php-zip php-gd php-mbstring php-curl php-xml php-pear php-bcmath
    
  • macOS: 使用 Homebrew 安装:

    brew install php
    
  • Windows: 可以从 PHP for Windows 下载并安装。

2. 安装 Composer

Composer 是 PHP 的依赖管理工具,Laravel 使用 Composer 来管理其依赖包。

  • Linux/macOS:

    php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
    php composer-setup.php
    php -r "unlink('composer-setup.php');"
    sudo mv composer.phar /usr/local/bin/composer
    
  • Windows: 下载并运行 Composer-Setup.exe

安装完成后,可以通过以下命令检查 Composer 是否安装成功:

composer --version

3. 安装 Laravel

使用 Composer 创建一个新的 Laravel 项目:

composer create-project --prefer-dist laravel/laravel blog

这将在当前目录下创建一个名为 blog 的 Laravel 项目。

4. 配置 Web 服务器

Laravel 项目需要一个 Web 服务器来运行。你可以使用 Apache、Nginx 或者 Laravel 自带的开发服务器。

  • 使用 Laravel 开发服务器: 在项目目录下运行以下命令:

    php artisan serve
    

    这将启动一个开发服务器,默认访问地址为 http://127.0.0.1:8000

  • 使用 Apache/Nginx: 你需要配置虚拟主机指向 Laravel 项目的 public 目录。例如,Apache 的配置可能如下:

    <VirtualHost *:80>
      DocumentRoot "/path/to/laravel/public"
      ServerName laravel.test
    
      <Directory "/path/to/laravel/public">
          AllowOverride All
          Require all granted
      </Directory>
    </VirtualHost>
    

5. 配置环境变量

Laravel 使用 .env 文件来管理环境变量。在项目根目录下,复制 .env.example 文件并重命名为 .env

cp .env.example .env

然后生成应用密钥:

php artisan key:generate

6. 配置数据库

.env 文件中配置数据库连接信息:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=your_password

确保你已经安装并运行了 MySQL 或其他支持的数据库。

7. 运行迁移

Laravel 提供了数据库迁移功能来管理数据库结构。你可以运行以下命令来创建默认的用户表:

php artisan migrate

8. 安装 Node.js 和 NPM(可选)

如果你需要使用 Laravel Mix 来编译前端资源(如 CSS 和 JavaScript),则需要安装 Node.js 和 NPM。

  • Linux/macOS:

    curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -
    sudo apt-get install -y nodejs
    
  • Windows: 下载并安装 Node.js

安装完成后,可以通过以下命令检查 Node.js 和 NPM 是否安装成功:

node -v
npm -v

然后在项目目录下运行以下命令安装前端依赖:

npm install

9. 编译前端资源(可选)

如果你使用了 Laravel Mix,可以通过以下命令编译前端资源:

npm run dev

或者在生产环境中使用:

npm run prod

10. 访问应用

现在你可以通过浏览器访问你的 Laravel 应用了。如果你使用了 Laravel 开发服务器,访问 http://127.0.0.1:8000 即可。

总结

通过以上步骤,你已经成功搭建了一个 Laravel 开发环境。接下来,你可以开始开发你的 Laravel 应用了。Laravel 提供了丰富的功能和工具,帮助你快速构建现代化的 Web 应用。