website

Laravel Docs

所属分类:开发者在线工具箱

Laravel 官方文档:按版本查阅安装、配置与各功能模块

Laravel Docs 是 Laravel 框架的官方文档站,按版本收录安装步骤、配置说明、核心架构概念和数据库、测试、扩展包等模块的用法。它面向使用 PHP 开发 Web 应用的开发者,尤其适合需要对照特定版本查阅接口和配置项的读者。

Laravel Docs:按版本查阅 Laravel 的安装、配置与各功能模块说明

发布于 2026年10月18日更新于 2026年10月29日

版本与左侧目录

文档站访问 laravel.com/docs 后会跳转到 Laravel 13.x 的 Installation 页面。页面顶部的 Version 菜单列出 Master、13.x、12.x 直到 5.0 以及 4.2 等版本,读者可以先选定自己项目所用的版本,再进入对应章节,避免把新版本的配置方式套用到旧项目上。

左侧目录分为几组:Prologue(发布说明、升级指南和贡献指南)、Getting Started(Installation、Configuration、Directory Structure、Frontend、Starter Kits、Deployment 等)、Architecture Concepts、The Basics、Digging Deeper、Security、Database、Eloquent ORM、AI、Testing、Packages,以及 API Documentation 和 Changelog。

Laravel 文档安装页,左侧为 Getting Started 目录,中间为 Installation 页面的 Meet Laravel 介绍,右侧为本页目录

安装页的内容

Installation 页面先用“Meet Laravel”介绍框架的定位:Laravel 是一个语法富有表现力的 Web 应用框架,提供应用结构和起点。页面的目录显示,它接着说明“Creating a Laravel Application”,包括安装 PHP 与 Laravel Installer 的方式,并提供 Herd 在 macOS 与 Windows 上的安装说明、IDE 支持、Laravel Boost 的安装,以及 Next Steps 中的全栈与 API 后端两条后续路线。

配置页与环境变量

Configuration 页面说明,Laravel 的全部配置文件都保存在 config 目录中,每个选项都有说明。它的“Environment Configuration”小节讲的是 .env 文件:全新安装时,项目根目录的 .env.example 会被复制为 .env,配置文件通过 env 函数读取其中的值。页面提醒,.env 中的变量可以被服务器或系统级环境变量覆盖,团队协作时应把带占位值的 .env.example 提交到版本库,而不是提交真实的 .env。

Laravel 配置页,标题为 Environment Configuration,正文说明 .env 文件与 env 函数,右侧为本页目录,包括环境变量类型、配置缓存和维护模式等条目

同一页右侧目录还列出 Environment Variable Types、Retrieving Environment Configuration、Determining the Current Environment、Encrypting Environment Files、Accessing Configuration Values、Configuration Caching、Configuration Publishing、Debug Mode 和 Maintenance Mode 等条目。读者遇到配置缓存、加密环境文件等问题时,可以直接跳到对应小节。

适合的查阅方式

文档分为“从零开始”的入门章节和按主题展开的参考章节。入门阶段可以依次阅读 Installation、Configuration、Directory Structure,理解项目的文件布局;需要具体接口或配置项时,再从左侧目录进入相应模块。站点顶部提供搜索框(快捷键 ⌘K),读者也可以直接搜索模块名。