Laravel 对系统有一些要求。固然,全部这些要求 Laravel Homestead 虚拟机都能知足,所以强烈推荐你使用 Homestead 最为你的开发环境。php
固然,假如你不使用 Homestead,请确保你的服务器知足如下要求:前端
Laravel 使用 Composer 来管理项目依赖。所以,在使用 Laravel 以前,请确保你的机器已经安装了 Composer。laravel
首先,经过使用 Composer 安装 Laravel 安装器:web
composer global require laravel/installer
确保将 composer's system-wide vendor bin 目录放置在你的系统环境变量 $PATH
中,以便系统能够找到 Laravel 的可执行文件。该目录根据你的操做系统存在不一样的位置中;一些常见的配置包括 :数据库
macOS: $HOME/.composer/vendor/bin GNU / Linux 发行版: $HOME/.config/composer/vendor/bin Windows: %USERPROFILE%\AppData\Roaming\Composer\vendor\bin
安装完成后,laravel new
命令会在你指定的目录建立一个全新的 Laravel 项目。例如, laravel new blog
将会建立一个名为 blog
的目录,并已安装好 Laravel 全部的依赖项:bootstrap
laravel new blog
或者,你也能够在终端中运行 create-project
命令来安装 Laravel:缓存
composer create-project --prefer-dist laravel/laravel blog
若是你在本地安装了 PHP, 而且你想使用 PHP 内置的服务器来为你的应用程序提供服务,则可使用 Artisan 命令serve
。该命令会在 http://localhost:8000
上启动开发服务器:安全
php artisan serve
固然,最好仍是选择 Homestead 和 Valet。bash
安装完 Laravel 以后,你应该配置你的 web 服务的文档目录指向 public
路径。该路径下的 index.php
文件做为进入应用的全部 HTTP 请求的前端控制器。服务器
Laravel 框架的全部配置文件存放在 config
目录下。每一个选项都有文档标注,便于经过文件查看并熟悉对你有用的选项。
在安装 Laravel 后,你可能须要配置一些权限。 storage
和 bootstrap/cache
目录在你的 web 服务下应该是可写的权限,不然 Laravel 将没法运行。若是你用的是 Homestead 虚拟机,这些权限应该已经设置好了。
安装好 Laravel 以后的下一步是设置你的应用秘钥为随机字符串。若是你经过 composer
或者 Laravel 安装器安装的,这个秘钥已经经过 php artisan key:generate
命令为你设置好了。
一般,这个字符串应该是 32 个字符长度。这个秘钥将会设置在环境变量文件 .env
中。若是你尚未将 .env.example
文件重命名为 .env
文件,你须要将 .env.example
文件重命名为 .env
文件。若是应用秘钥尚未设置,你的用户会话和其余的加密数据将会不安全!
Laravel 几乎不须要除上面所说的其余什么配置了。你能够为所欲为的开始开发了!然而,你可能会想要再次查看 config/app.php
文件和它的注释说明。它包含一些你可能但愿根据你应用来更改的选项,诸如: timezone
和 locale
。
你还可能想要配置 Laravel 的其余的一些组件,例如:
Laravel 中包含了一个 public/.htaccess
文件一般用于在资源路径中隐藏 index.php
的前端控制器。在用 Apache 为 Laravel 提供服务以前,确保启用了 mod_write
模块,这样 .htaccess
文件才能被服务器解析。
若是 Laravel 附带的 .htaccess
文件不起做用,尝试下面的方法替代:
Options +FollowSymLinks -Indexes RewriteEngine On RewriteCond %{HTTP:Authorization} . RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}] RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^ index.php [L]
若是你使用 Nginx ,在你的站点配置中加入如下配置,全部的请求将会引导至 index.php
前端控制器。
location / { try_files $uri $uri/ /index.php?$query_string; }
当你使用 Homestead 或者 Valet 时,优雅连接将会自动配置好。