Laravel Laravel
  • 前言

    • 发行说明
    • 升级说明
    • 贡献导引
    • API 文档
  • 入门指南

    • 安装
    • 配置
    • 文件夹结构
    • 请求生命周期
  • 开发环境部署

    • Homestead
    • Valet
  • 核心概念

    • 服务容器
    • 服务提供者
    • Facades:门面
    • Contracts:契约
  • HTTP 层

    • 路由
    • 中间件
    • CSRF 保护
    • 控制器
    • 请求
    • 响应
    • Session
    • 表单验证
  • 视图和模板

    • 视图
    • Blade 模板
    • 本地化
  • JavaScript & CSS

    • 入门指南
    • 编译资源
  • 安全

    • 用户认证
    • 用户授权
    • 重置密码
    • API 认证
    • 加密解密
    • 哈希
  • 综合话题

    • 广播系统
    • 缓存
    • 错误与日志
    • 事件
    • 文件存储
    • 邮件发送
    • 消息通知
    • 队列
  • 数据库

    • 快速入门
    • 查询构造器
    • 分页
    • 数据库迁移
    • 数据填充
    • Redis
  • Eloquent ORM

    • 快速入门
    • 模型关联
    • Eloquent 集合
    • 修改器
    • 序列化
  • Artisan 控制台

    • Artisan 命令行
    • 任务调度
  • 测试

    • 快速入门
    • 应用程序测试
    • 数据库
    • 模拟器
  • 官方扩展包

    • Cashier交易工具包
    • Envoy 部署工具
    • Passport OAuth 认证
    • Scout全文搜索
    • Socialite社会化登录
  • 附录

    • 集合
    • 辅助函数
    • 扩展包开发
Icon

提示 您正在浏览旧版本的 Laravel 的文档. 请考虑将你的项目升级到 Laravel 9.x.

236 7

安装
5.3
8.5 8.x 7.x 6.x 5.8 5.7 5.6 5.5 5.4 5.3 5.2 5.1

Laravel 5.3 中文文档 /

未匹配的标注
本文档最新版为 8.5,旧版本可能放弃维护,推荐阅读最新版!

安装

  • 安装
    • 运行环境要求
    • 安装 Laravel
    • 配置信息

安装

运行环境要求

Laravel 框架会有一些系统上的要求。当然,这些要求在 Laravel Homestead 虚拟机上都已经完全配置好了,强烈建议使用 Homestead 作为本地开发环境。

系统要求为以下:

  • PHP >= 5.6.4
  • OpenSSL PHP Extension
  • PDO PHP Extension
  • Mbstring PHP Extension
  • Tokenizer PHP Extension
  • XML PHP Extension

译者注:强烈推荐使用 Homestead 作为开发环境,尤其是新手,可以避免很多不必要的麻烦。线上环境可以参考 Homestead 的环境部署脚本 进行部署。

安装 Laravel

Laravel 使用 Composer 来管理代码依赖。所以,在使用 Laravel 之前,请先确认你的电脑上安装了 Composer。

通过 Laravel 安装工具

首先,使用 Composer 下载 Laravel 安装包:

composer global require "laravel/installer"

请确定你已将 ~/.composer/vendor/bin 路径加到 PATH,只有这样系统才能找到 laravel 的执行文件。

一旦安装完成,就可以使用 laravel new 命令在指定目录创建一个新的 Laravel 项目,例如:laravel new blog 将会在当前目录下创建一个叫 blog 的目录,此目录里面存放着新安装的 Laravel 和代码依赖。这个方法的安装速度比通过 Composer 安装要快上许多:

laravel new blog

因为代码依赖是直接一起打包安装的。

通过 Composer Create-Project

除此之外,你也可以通过 Composer 在命令行运行 create-project 命令来安装 Laravel:

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

译者注: 安装 Laravel 5.3,请使用以下命令:

composer create-project laravel/laravel your-project-name --prefer-dist "5.3.*"

本地开发服务器

如果你在本地安装了 PHP,你可能希望像运行 PHP 内置的开发服务器一样来访问自己的应用程序,你可以使用 serve Artisan 命令来启动一个本地开发服务器,这样你就可以在 http://localhost:8000 来访问它。

php artisan serve

不过有更健壮的本地开发选项可用,比如 Homestead 和 Valet。

配置信息

Public 目录

安装完成后,你应该指定 Web 服务器的网站根目录到 public 文件夹上。index.php 文件是 Laravel 的主要入口文件。

配置文件

所有 Laravel 框架的配置文件都放置在 config 目录下。每个选项都有说明,请仔细阅读这些说明,并熟悉这些选项配置。

目录权限

安装 Laravel 之后,你必须设置一些文件目录权限。storage 和 bootstrap/cache 目录必须让服务器有写入权限。如果你使用 Homestead 虚拟机,那么这些权限已经被设置好了。

应用程序密钥

在你安装完 Laravel 后,首先需要做的事情是设置一个随机字符串的密钥。假设你是通过 Composer 或是 Laravel 安装工具安装的 Laravel,那么这个密钥已经通过 key:generate 命令帮你设置完成。通常这个密钥会有 32 字符长。这个密钥可以被设置在 .env 环境文件中。如果你还没将 .env.example 文件重命名为 .env,那么你现在应该去设置下。

如果应用程序密钥没有被设置的话,你的用户 Session 和其它的加密数据都是不安全的!

其它设置

Laravel 几乎不需做任何其它设置就可以马上使用,但是建议你先浏览 config/app.php 文件和对应的文档,这里面包含着一些选项,如 时区 和 语言环境,你可以根据应用程序的情况来修改。

你也可以设置 Laravel 的几个附加组件,像是:

  • 缓存
  • 数据库
  • Session

一旦 Laravel 安装完成,你应该立即 设置本机环境。


{note} 欢迎任何形式的转载,但请务必注明出处,尊重他人劳动共创开源社区。

转载请注明:本文档由 Laravel China 社区 [laravel-china.org] 组织翻译,详见 翻译召集帖。

文档永久地址: d.laravel-china.org

本文章首发在 网站上。

上一篇 下一篇

成为Laravel合作伙伴

Laravel Partners是提供一流Laravel开发和咨询服务的精英商店。我们每个合作伙伴都可以帮助您制定一个精美,结构完善的项目.

我们的伙伴
Laravel
亮点
  • Our Team
  • Release Notes
  • Getting Started
  • Routing
  • Blade Templates
  • Authentication
  • Authorization
  • Artisan Console
  • Database
  • Eloquent ORM
  • Testing
资源
  • Laracasts
  • Laravel News
  • Laracon
  • Laracon EU
  • Jobs
  • Certification
  • Forums
  • 版本发布时间
  • 包开发
  • 命令行应用
  • TALL stack全栈开发
  • Blade UI Kit
  • 前端资源构建
伙伴
  • Vehikl
  • Tighten Co.
  • Kirschbaum
  • Byte 5
  • 64 Robots
  • Cubet
  • DevSquad
  • Ideil
  • Cyber-Duck
  • ABOUT YOU
  • A2 Design
  • Romega Software
  • Jump24
  • Become A Partner
生态系统
  • Cashier
  • Dusk
  • Echo
  • Envoyer
  • Forge
  • Homestead
  • Horizon
  • Lumen
  • Mix
  • Nova
  • Passport
  • Scout
  • Socialite
  • Spark
  • Telescope
  • Valet
  • Vapor

Laravel是一个具有表达力,优雅语法的Web应用程序框架。我们认为,发展必须是一种令人愉悦的创造力,才能真正实现。Laravel试图通过减轻大多数Web项目中使用的常见任务来减轻开发的痛苦.

Laravel是Taylor Otwell的商标.
Copyright © 2011-2022 Laravel中文网 LLC.

  • Twitter
  • GitHub
  • Discord
Laravel PHP中文网 推荐使用阿里云