推荐用 Composer 的 create-project 命令安装 Laravel,确保 PHP ≥ 8.1 并启用必要扩展,配置 .env 后运行 php artisan serve 即可启动开发服务器。

安装和配置 Laravel 很简单,关键是选对方式、避开常见坑。推荐用 Composer 安装官方 Laravel 安装器或直接用 create-project 命令,不建议手动下载 ZIP 或从 GitHub 克隆源码——容易缺依赖、版本混乱。
确保基础环境已就绪
Laravel 10+ 要求 PHP ≥ 8.1,且需启用以下扩展:openssl、pdo、mbstring、tokenizer、xml、ctype、json、curl。Windows 用户推荐用 Laragon 或 XAMPP(开启对应扩展);Mac 用户可用 PHP 8.2+ via Homebrew;Linux(如 Ubuntu)可执行:
sudo apt update && sudo apt install php8.2-cli php8.2-mbstring php8.2-xml php8.2-sqlite3 php8.2-curl- 确认 Composer 已安装:
composer --version(没装就去 getcomposer.org 下载并全局配置)
用 Composer 创建新项目
在终端中进入你想存放项目的目录(比如 ~/Sites 或 D:\laravel-apps),运行:
-
composer create-project laravel/laravel blog(会创建名为blog的新项目,自动拉取最新稳定版) - 想指定版本?加版本号:
composer create-project laravel/laravel blog "10.*" - 安装完进入项目:
cd blog
不用全局安装 laravel/installer ——它已过时,Laravel 官方自 9.x 起不再维护该工具。
启动开发服务器并验证
运行:
php artisan serve- 默认访问 https://www.php.cn/link/f0838b2ebfc6440a474eabdc326bf31a,看到 Laravel 欢迎页即成功
- 端口被占?换端口:
php artisan serve --port=8080
注意:Artisan 服务仅用于本地开发,别用在生产环境。
基本配置要点(第一次必看)
打开项目根目录的 .env 文件,修改这几项:
-
APP_NAME:改成你的应用名,比如
APP_NAME=MyBlog -
APP_URL:开发时保持
https://www.php.cn/link/f0838b2ebfc6440a474eabdc326bf31a即可 -
DB_CONNECTION:默认是
sqlite,新手可先不改;想用 MySQL,填上mysql并配好DB_HOST、DB_DATABASE等 -
APP_KEY:安装时已自动生成(
php artisan key:generate),别手动改,除非密钥丢失
改完 .env 后,清下配置缓存(虽然首次不用,但养成习惯):php artisan config:clear
基本上就这些。不复杂但容易忽略环境检查和 .env 配置。跑通欢迎页后,就可以开始学路由、控制器和 Blade 模板了。










