繁体

windows下安装larval

老刘

Windows 下安装 Laravel：从环境准备到项目跑起来，一篇讲明白

关键词：Windows 下安装 Laravel

很多人第一次在 Windows 上装 Laravel，最容易卡在三个地方：

  1. PHP 版本不对
  2. Composer 没装好
  3. 扩展、环境变量、数据库连接配置出问题

Laravel 本身不是“装一个软件就能用”的那种程序，它更像是一套 PHP Web 开发框架，所以要先把 PHP、Composer、数据库、Web 运行环境 这些基础搭好，Laravel 才能正常启动。

下面我按新手也能看懂的方式，带你一步一步完成 Windows 下安装 Laravel，尽量用最省事、最低成本的方法来做。

一、先弄明白：安装 Laravel 需要什么

在 Windows 上安装 Laravel，最基本需要这几个东西：

  • PHP
  • Composer
  • 数据库（常见是 MySQL / MariaDB）
  • 一个项目目录
  • 可选：Apache / Nginx，或者直接用 Laravel 自带开发服务器

如果你只是本地开发，最省事的方式是：

  • PHP + Composer + MySQL
  • 然后直接用 php artisan serve 启动项目

这样不需要先折腾 Apache 或 Nginx，新手最友好。

二、安装前的版本建议

Laravel 对 PHP 版本有要求，而且版本不匹配是最常见的报错原因之一。

建议搭配

  • Windows 10 / Windows 11
  • PHP 8.2 或 8.3
  • Composer 2.x
  • Laravel 10 / 11
  • MySQL 8.0 或 MariaDB 10.5+

如果你是刚开始学，建议直接用：

  • PHP 8.2
  • Laravel 10 或 11
  • MySQL 8

兼容性和资料都比较多。

三、安装 PHP

方法一：直接装集成环境（最省事，适合小白）

如果你不想自己手动配 PHP、扩展、数据库，建议直接用：

  • XAMPP
  • WampServer
  • Laragon

其中我最推荐 Laragon，原因很简单：

  • 对 Laravel 友好
  • 配置简单
  • 自带 PHP、MySQL
  • 创建项目方便
  • 启动快，适合 Windows 开发

Laragon 安装步骤

  1. 去官网下载 Laragon
  2. 一路下一步安装
  3. 打开后确认：
    • Apache 或 Nginx 已启动
    • MySQL 已启动
    • PHP 版本符合要求

安装完以后，你可以在命令行输入：

php -v

如果能看到版本号，说明 PHP 已经正常可用。

方法二：手动安装 PHP（适合想自己掌控环境的人）

如果你不想用集成环境，也可以手动装 PHP。

步骤

  1. 下载 PHP Windows 版压缩包
    建议下载 Thread Safe 或根据你的运行方式选择合适版本。
  2. 解压到例如： 
    C:\php
  3. 配置环境变量：
    • 打开“系统属性”
    • 进入“环境变量”
    • 在 Path 里添加： 
      C:\php
  4. 关闭并重新打开命令提示符，输入： 
    php -v

PHP 必须开启的常用扩展

Laravel 常用扩展通常需要这些：

  • openssl
  • pdo
  • mbstring
  • tokenizer
  • xml
  • ctype
  • json
  • fileinfo
  • curl
  • zip

如果你用的是 PHP 配置文件 php.ini，要把相关扩展开启，不然 Laravel 可能会报错。

四、安装 Composer

Laravel 最核心的依赖管理工具就是 Composer，没有它，Laravel 装不起来。

安装步骤

  1. 打开 Composer 官网下载安装包
  2. 安装时会自动检测 PHP 路径
  3. 如果没自动识别，就手动指定 php.exe 的位置
  4. 安装完成后，打开命令行输入：
composer -V

如果显示版本号，说明 Composer 安装成功。

常见问题

1. 提示“composer 不是内部或外部命令”

说明 Composer 没加到环境变量里。

解决方法：

  • 重新安装 Composer
  • 或检查系统 Path 是否包含 Composer 安装目录

2. 提示 PHP 版本不符合

说明你电脑上的 PHP 版本太低，或者 Composer 绑定了错误的 PHP 路径。

解决方法：

  • 输入： 
    where php

    看看系统到底调用的是哪个 PHP

  • 确保命令行里的 PHP 是你想用的版本

五、安装数据库

Laravel 最常用数据库是 MySQL。

如果你用 Laragon / XAMPP

一般已经自带数据库，直接打开控制面板启动即可。

如果你单独安装 MySQL

建议安装 MySQL 8.0，设置好：

  • root 密码
  • 端口默认 3306
  • 编码使用 utf8mb4

后面 Laravel 连接数据库时会用到这些信息。

六、安装 Laravel

环境准备好了，就可以开始真正安装 Laravel 了。

方式一：直接用 Composer 创建项目

这是最常见的方法。

打开命令行，进入你想放项目的目录，例如：

cd D:\www

然后输入：

composer create-project laravel/laravel myapp

这里的 myapp 是项目文件夹名，你可以改成自己想要的名字。

安装完成后，进入项目目录：

cd myapp

方式二：先全局安装 Laravel Installer

这种方式适合经常新建项目的人。

先执行：

composer global require laravel/installer

然后把 Composer 全局 bin 目录加入环境变量。通常路径类似：

C:\Users\你的用户名\AppData\Roaming\Composer\vendor\bin

配置好后，就能用：

laravel new myapp

这种方式创建项目更方便，但对新手来说，前期环境配置会稍微多一点。

七、启动 Laravel 项目

进入项目目录后，执行：

php artisan serve

正常情况下，你会看到类似提示：

Starting Laravel development server: http://127.0.0.1:8000

然后打开浏览器访问：

http://127.0.0.1:8000

如果页面能正常打开，说明 Laravel 已经跑起来了。

八、配置 .env 文件

Laravel 项目的很多参数都在 .env 文件里配置，尤其是数据库连接。

找到项目根目录下的 .env 文件，修改数据库配置，例如：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_test
DB_USERNAME=root
DB_PASSWORD=你的密码

说明

  • DB_DATABASE：数据库名，要提前在 MySQL 里建好
  • DB_USERNAME：数据库用户名
  • DB_PASSWORD：数据库密码

九、创建数据库并执行迁移

Laravel 默认自带一些迁移文件，你可以先把数据库建好，然后执行迁移。

1. 创建数据库

可以在 phpMyAdmin、Navicat、MySQL Workbench 里建库，也可以直接命令行创建。

比如数据库名叫：

laravel_test

2. 执行迁移

在项目目录执行：

php artisan migrate

如果数据库配置正确，这一步会把 Laravel 自带的表结构创建出来。

十、Windows 下安装 Laravel 常见报错与解决办法

1. 提示“PHP 扩展缺失”

例如报错：

  • ext-mbstring
  • ext-xml
  • ext-curl
  • ext-zip

解决方法

打开 php.ini，找到对应扩展，把前面的分号 ; 去掉，例如：

extension=mbstring
extension=xml
extension=curl
extension=zip

保存后，重启命令行，再运行：

php -m

确认扩展已经启用。

2. 提示“openssl 相关错误”

Laravel 和 Composer 都经常用到 SSL，如果 openssl 没开，就会出问题。

解决方法

在 php.ini 中找到：

extension=openssl

确保它没有被注释掉。

3. artisan serve 运行失败

有时会出现端口被占用，或者 PHP 配置异常。

解决方法

先查看端口是否被占用：

netstat -ano | findstr 8000

如果 8000 被占用，可以换端口启动：

php artisan serve --port=8080

然后访问：

http://127.0.0.1:8080

4. Composer 下载很慢

这是很多国内用户都会遇到的问题。

解决方法

可以切换 Composer 镜像源，提高下载速度。

常见做法是设置国内镜像，例如：

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

如果后面想恢复默认源，可以再改回去。

5. 命令行找不到 php

说明 PHP 没进环境变量，或者命令行没刷新。

解决方法

  1. 检查 Path 是否包含 PHP 路径
  2. 关闭所有命令行窗口重新打开
  3. 输入： 
    where php

    查看系统实际调用的是哪个 php.exe

十一、推荐给新手的最稳方案

如果你是第一次在 Windows 上装 Laravel，我建议直接按这个顺序来：

方案 A：最省事

  • 安装 Laragon
  • 确认 PHP 版本符合要求
  • 安装 Composer
  • 创建 Laravel 项目
  • 配置 .env
  • 运行 php artisan serve

这个方案最适合新手，坑少。

方案 B：稍微专业一点

  • 手动安装 PHP
  • 安装 Composer
  • 安装 MySQL
  • 配置环境变量
  • 用 Composer 创建 Laravel 项目

这个方案更灵活，适合以后做更复杂的开发环境。

十二、完整安装流程总结

你可以按下面这个顺序操作：

  1. 安装 PHP 或集成环境
  2. 检查 PHP 版本
  3. 安装 Composer
  4. 安装数据库 MySQL
  5. 使用 Composer 创建 Laravel 项目
  6. 配置 .env 数据库信息
  7. 执行 php artisan serve
  8. 浏览器访问项目地址
  9. 如需数据库功能，执行 php artisan migrate

十三、给小白的最简操作版

如果你不想看太多细节，直接照这个做：

第一步：装 Laragon

安装后打开，确认 PHP 和 MySQL 都启动了。

第二步：装 Composer

装好后在命令行输入：

composer -V

能显示版本就行。

第三步：创建 Laravel 项目

进入项目目录，执行：

composer create-project laravel/laravel myapp

第四步：进入项目并启动

cd myapp
php artisan serve

第五步：浏览器打开

http://127.0.0.1:8000

能打开页面，就说明安装成功。

十四、安装后的实用优化建议

1. 项目目录别放太深

建议放在简单路径里，比如：

D:\www\myapp

不要放在中文路径、空格太多的路径里，避免某些工具报错。

2. 尽量统一 PHP 版本

电脑里如果装了多个 PHP，容易出现“命令行调用的版本”和“网页运行版本”不一致的问题。

3. 备份 .env

.env 里有数据库密码和配置，一定要保留好，重装环境时很重要。

4. 生产环境别用 php artisan serve

这个命令只是开发调试用，正式上线建议使用 Nginx/Apache 配合 PHP-FPM 或 Windows 下的正式部署方案。

十五、结语式总结

在 Windows 下安装 Laravel，核心不是“直接装框架”，而是先把 PHP、Composer、数据库、环境变量 这些基础配齐。
对新手来说，最稳的路线就是：Laragon + Composer + Laravel + MySQL。
只要版本匹配、扩展开启、环境变量正确，Laravel 在 Windows 上其实并不难装，关键就是一步一步来，不要跳步骤。

文章版权声明：文章内容均来源于各大短视频平台搜集以及修改和删减新增，如有侵权或者违规，请联系站长进行删除，如需转载或复制请以超链接形式并注明出处。

相关阅读

发表评论

快捷回复： 表情：
AddoilApplauseBadlaughBombCoffeeFabulousFacepalmFecesFrownHeyhaInsidiousKeepFightingNoProbPigHeadShockedSinistersmileSlapSocialSweatTolaughWatermelonWittyWowYeahYellowdog
验证码
评论列表 （暂无评论，3人围观）

还没有评论，来说两句吧...

目录[+]