mac安装laravel、lumen

概述

laravel：The PHP Framework For Web Artisans.
lumen：The stunningly fast micro-framework by Laravel.

本文介绍了在mac下安装laravel、lumen的过程。

composer

安装laravel、lumen需要使用composer。

打开命令行工具，cd到指定的安装目录，例如/usr/local/bin（也可以下载完再复制到安装目录）：

cd /usr/local/bin

执行以下命令，下载composer.phar，最新的下载命令可以点击这里：

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"php -r "if (hash_file('SHA384', 'composer-setup.php') === 'aa96f26c2b67226a324c27919f1eb05f21c248b987e6195cad9690d5c1ff713d53020a02ac8c217dbf90a7eacc9d141d') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"php composer-setup.phpphp -r "unlink('composer-setup.php');"

下载完成后创建链接：

ln -s composer.phar composer

执行composer --version，如果得到类似如下输出，即表示安装成功：

Composer version 1.2.0 2016-07-19 01:28:52

laravel

laravel的当前版本为5.3.0。

执行命令：

composer global require "laravel/installer"

文本编辑器打开~/.bash_profile，输入以下内容后保存，执行source ~/.bash_profile更新配置文件：

export PATH=~/.composer/vendor/bin:$PATH

警告：export PATH=~/.composer/vendor/bin:$PATH一定要把:$PATH添加回去，不然后果很严重。

打开工作目录（笔者的为/Web）：

cd /Web

创建项目，假设项目路径为blog/laravel：

laravel new blog/laravel

也可以使用composer命令：

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

如果要使用指定版本的laravel，比如5.2，可以从github下载分支的代码，解压并移动laravel-5.2到路径/Web/blog/laravel，打开该目录后执行：

composer install

创建web文档链接到blog/laravel/public（其中/Web/blog/laravel是项目目录，/Web/www是笔者的文档根目录，也可以直接把nginx的文档根目录设置为/Web/blog/laravel/public）：

ln -s /Web/blog/laravel/public /Web/www/blog_laravel

打开浏览器输入http://localhost/blog_laravel：
如果看到如下页面即表示安装成功：

Laravel

DOCUMENTATION LARACASTS NEWS FORGE GITHUB

可能出现的问题：

An error occurred.
Sorry, the page you are looking for is currently unavilable.
Please try again later.If you are the system administrator of this resource then you should check the error log for details.
Faithfully yours, nginx.

查看nginx日志：

PHP message: PHP Fatal error: Uncaught UnexpectedValueException: The stream or file “/ /Web/blog/laravel/storage/logs/laravel.log” could not be opened: failed to open stream: Permission denied in /Web/blog/laravel/vendor/monolog/monolog/src/Monolog/Handler/StreamHandler.php:107

解决方案：

cd /Web/blog/laravelchmod -R 777 storage

laravel的配置和使用可以参照Laravel官网或者Laravel中文网的文档。
laravel的官方文档提供了很多有用的信息，推荐阅读。
以下是一些配置和使用笔记。

可能需要的几个配置：

@config/app.php
‘name’ => ‘Your Application’, // 你的应用程序名字
‘timezone’ => ‘Asia/Shanghai’, // 面向中国
‘locale’ => ‘zh_CN’, // 本地化，需要把resources/lang/en复制一份为resources/lang/zh_CN后作相应的修改

在PHP代码里得到配置可以通过$value = config('app.timezone');之类的语句来完成。更新配置则可以通过config(['app.timezone' => 'America/Chicago']);之类的语句来完成。

一些配置文件项使用了环境变量，比如：'debug' => env('APP_DEBUG', false)，将读取环境变量的APP_DEBUG值，环境变量未指定时则使用默认值false。环境变量的文件保存在laravel根目录下的.env，如果不存在这个文件，可以手动复制.env.example为.env。不同的开发者／服务器将会使用不同的环境设置。

生产环境下应该使用php artisan config:cache命令缓存配置文件，这样可以提高运行速度。使用php artisan config:clear可以清除缓存。

使用php artisan down命令可以启用维护模式，php artisan up则可以退出维护模式。

使用php artisan storage:link可以创建public/storage链接，用于保存应用生成的文件，链接的源位置为storage/app/public。

tests目录下存放测试用例，测试类以Test作为后缀命名。执行phpunit或者php vendor/bin/phpunit可以运行测试用例。

app目录下的很多类可以通过Artisan命令生成，比如php artisan make:model HelloModel将在app目录下生成一个HelloModel的模版文件。可用执行php artisan list make查看可用的Artisan make命令，以下是当前版本（5.3.0）的参考输出，更多的目录说明请参考官方文档：

Available commands for the “make” namespace:
make:auth Scaffold basic login and registration views and routes
make:command Create a new Artisan command
make:controller Create a new controller class
make:event Create a new event class
make:job Create a new job class
make:listener Create a new event listener class
make:mail Create a new email class
make:middleware Create a new middleware class
make:migration Create a new migration file
make:model Create a new Eloquent model class
make:notification Create a new notification class
make:policy Create a new policy class
make:provider Create a new service provider class
make:request Create a new form request class
make:seeder Create a new seeder class
make:test Create a new test class

代码里可以使用abort可以生成http状态码的应答，比如abort(404);，abort(403, 'Unauthorized action.');。

更多细节请参考官方文档。

lumen

lumen的当前版本是5.2.8。

打开工作目录（笔者的为/Web）：

cd /Web

创建项目，假设项目名为blog/lumen，
执行composer命令：

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

创建web文档链接到blog/lumen/public（其中/Web/blog/lumen是项目目录，/Web/www是笔者的文档根目录，也可以直接把文档根目录设置为/Web/blog/lumen/public）：

ln -s /Web/blog/lumen/public /Web/www/blog_lumen

打开浏览器输入http://localhost/blog_lumen：
如果看到如下页面即表示安装成功：

Lumen (5.2.8) (Laravel Components 5.2.*)

可能出现的错误：

Sorry, the page you are looking for could not be found.

解决方案：
打开public/index.php，把最后一行代码$app->run()修改为：$app->run($app['request'])。

相关文档：

mac安装nginx、php和postgresql

参考文档：

1. Laravel - The PHP Framework For Web Artisans
2. Laravel-简洁、优雅的PHP开发框架(PHP Web Framework)
3. Symfony, High Performance PHP Framework for Web Development
4. “最好的 PHP 框架”调查报告（2015版）
5. Installation - Laravel - The PHP Framework For Web Artisans
6. Configuration - Laravel - The PHP Framework For Web Artisans
7. php - Error: laravel.log could not be opened - Stack Overflow
8. lumen进入一直显示Sorry, the page you are looking for could not be found.
9. Lumen 初体验
10. linux权限—【600，644，700，755，711，666，777】
11. php - Config cache in laravel 5 results in view not found - Stack Overflow