推荐用 Composer 的 create-project 命令安装 Laravel,确保 PHP ≥ 8.1 并启用必要扩展,配置 .env 后运行 php artisan serve 即可启动开发服务器。
安装和配置 Laravel 很简单,关键是选对方式、避开常见坑。推荐用 Composer 安装官方 Laravel 安装器或直接用
命令,不建议手动下载 ZIP 或从 GitHub 克隆源码——容易缺依赖、版本混乱。
确保基础环境已就绪
Laravel 10+ 要求 PHP ≥ 8.1,且需启用以下扩展:
、
、
、
、
、
、
、
。Windows 用户推荐用
Laragon
或
XAMPP
(开启对应扩展);Mac 用户可用
PHP 8.2+ via Homebrew
;Linux(如 Ubuntu)可执行:
确认 Composer 已安装:
(没装就去
getcomposer.org
下载并全局配置)
用 Composer 创建新项目
在终端中进入你想存放项目的目录(比如
或
),运行:
(会创建名为
的新项目,自动拉取最新稳定版)
想指定版本?加版本号:
安装完进入项目:
不用全局安装
——它已过时,Laravel 官方自 9.x 起不再维护该工具。
启动开发服务器并验证
运行:
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。
下载
默认访问
https://www.php.cn/link/f0838b2ebfc6440a474eabdc326bf31a
,看到 Laravel 欢迎页即成功
端口被占?换端口:
注意:Artisan 服务仅用于本地开发,别用在生产环境。
基本配置要点(第一次必看)
打开项目根目录的
.env
文件,修改这几项:
APP_NAME
:改成你的应用名,比如
APP_URL
:开发时保持
即可
DB_CONNECTION
:默认是
,新手可先不改;想用 MySQL,填上
并配好
、
等
APP_KEY
:安装时已自动生成(
),别手动改,除非密钥丢失
改完
后,清下配置缓存(虽然首次不用,但养成习惯):
基本上就这些。不复杂但容易忽略环境检查和 .env 配置。跑通欢迎页后,就可以开始学路由、控制器和 Blade 模板了。
create-projectopensslpdombstringtokenizerxmlctypejsoncurlsudo apt update && sudo apt install php8.2-cli php8.2-mbstring php8.2-xml php8.2-sqlite3 php8.2-curlcomposer --version~/SitesD:\laravel-appscomposer create-project laravel/laravel blogblogcomposer create-project laravel/laravel blog "10.*"cd bloglaravel/installerphp artisan servephp artisan serve --port=8080APP_NAME=MyBloghttps://www.php.cn/link/f0838b2ebfc6440a474eabdc326bf31asqlitemysqlDB_HOSTDB_DATABASEphp artisan key:generate.envphp artisan config:clear