通过这整个系列，最终将会开发完成一个简化版的博客 APP. 在这次的文章中，暂时不会涉及数据库操作和领域模型相关的开发，而是聚焦于 Spiral 框架的路由（route）和控制器（controller）部分。 ...继续阅读 (14)

本文通过详细的步骤介绍了 Spiral 框架的 WEB 项目初始化，采用官网提供的 WEB 项目骨架创建项目，随后介绍目录结构及各个目录和文件的作用。同时介绍了在项目骨架提示不明确的情况下，如何对各个组件进行配置修改。 ...继续阅读 (9)

Spiral 是一个基于 PHP 和 Golang 的混合开发框架，它的理念是让 PHP 负责业务逻辑（应用程序）的开发，而 Golang 负责底层基础服务，这样一来能够很好地把 Golang 的高性能和 PHP 的快速开发和快速部署结合起来。在 techempower.com 对 PHP 框架性能的测试中，Spiral 排名第 6，远远超越了 laravel-swoole, phalcon, hyperf, symfony, laravel, codeigniter, cakephp 等框架。 ...继续阅读 (11)

本文介绍了如果借助 Git 的 Conditional Includes 功能，自动根据代码仓库在本地不同的位置，自动应用不同的配置文件，主要用于自动配置用户邮箱和名称。 ...继续阅读 (16)

最近发现 iTerm2 下的 $PATH 变量里出现重复的几组路径（npm, composer, go 相关的），一开始以为是重复定义了，排查了半天发现不是。上网搜了一下，找到一个解决方案： 在 ~/.zshrc 文件中最后一次 export PATH之后加入一行： typeset -aU path 这样 $PATH 变量里的所有路径就都是唯一的了。 原理是什么呢？path 和 PATH 是不同的。通过在变量前面加上变量扩展 t 来检查： $ echo ${(t)path} array-tied-unique-special $ echo ${(t)PATH} scalar-tied-export-special 但它们是链接变量，你更改一个变量就会同时更改另一个变量，但它们具有不同的属性。具体 scalar-export-special 的特殊性是什么，抱歉，我是真不知道（因为原文作者也说他不知道，更别说我这个翻译的了…… zsh 是真的毫无研究啊）。 typeset 声明就简单多了，它将路径类型从 array-special 更改为 array-unique-special. -a 标志表示数组，-U 标志表示唯一。 参考文章： Remove duplicates in zsh $PATH Stack Overflow 的讨论 ...继续阅读 (9)

Laravel 5.5 版本引入了一个新的 migrate:fresh 命令，它跟之前用来重置数据库结构的 migrate:refresh 非常像，但又有所区别，在开发中，新的 migrate:fresh 命令要更快捷和高效。本文介绍了这两个命令的具体区别。 ...继续阅读 (6)

Laravel 5.5 的路由中增加了一种新的返回类型：可相应接口（Responsable）。该接口允许对象在从控制器或者闭包路由中返回时自动被转化为标准的 HTTP 响应接口。任何实现 Responsable 接口的对象必须实现一个名为 toResponse() 的方法，该方法将对象转化为 HTTP 响应对象。看示例： use Illuminate\Contracts\Support\Responsable; class ExampleObject implements Responsable { public function __construct($name = null) { $this->name = $name ?? 'Teapot'; } public function status() { switch(strtolower($this->name)) { case 'teapot': return 418; default: return 200; } } public function toResponse() { return response( Hello {$this->name}, $this->status(), ['X-Person' […] ...继续阅读 (3)

本文介绍了在 Nginx 下如何泛解析域名到子目录，并且根据子目录下是否有 public 目录自动识别 laravel 框架并做相应的根目录设定，相比 valet, 更具有通用型，并且能解决 valet 下 PHP 错误不能正确反映错误代码所在文件和行数的问题。 ...继续阅读 (6)

在以前的版本中，当使用 `artisan vendor:publish` 命令来发布扩展包的资源时，需要自己指定 `--provider` 参数或者 `--tag` 参数来确定要发布什么资源。比如 `--provider="Barryvdh\Debugbar\ServiceProvider"`，用于发布指定 provider 包含的资源，或者 `--tag=config` 这样的命令。如果你什么参数都不加的话，默认会发布所有 provider 包含的所有资源（配置文件、视图、样式和JS等）。在 Laravel 5.5 中，做了一点增强，让使用上更方便了。 ...继续阅读 (16)

Laravel 5.5 再过一个多月就要发布了，这将是 Laravel 框架的下一个 LTS release（长期支持版）。本文介绍了在 Laravel 5.5 正式发布之前，如何提前创建基于 Laravel 5.5 的项目，来提前体验新版本，以及为新版本开发兼容的扩展。 ...继续阅读 (13)

Laravel 5.5 将于 2017年7月发布，这将是继 Laravel 5.1 之后的下一个长期支持版本，相比之前发布的几个“中间版本”而言，意义重大。目前我在内部项目中已经在使用 Laravel 5.5，接下来会连续地翻译、撰写相关 Laravel 5.5 版本的文章。本文简单介绍一下关于 Laravel 5.5 发布的相关信息，以及有关升级到 PHP 7的预告。 ...继续阅读 (7)

Google 在 2016年9月份开源了他们的优化网络拥堵算法`BBR`，最新版本的 Linux内核（4.9-rc8）中已经集成了该算法。对于TCP单边加速，并非所有人都很熟悉，不过有另外一个大名鼎鼎的商业软件“锐速”，相信很多人都清楚。特别是对于使用国外服务器或者VPS的人来说，效果更佳。网上有很多在 Debian 和 Ubuntu 系统下启用 BBR 的教程，我就不粘贴了，我自己一直用的是 CentOS，本文介绍一下在 64位 CentOS 7 系统下开启BBR的方法。 ...继续阅读 (15)

Google 在 2016年9月份开源了他们的优化网络拥堵算法`BBR`，最新版本的 Linux内核（4.9-rc8）中已经集成了该算法。对于TCP单边加速，并非所有人都很熟悉，不过有另外一个大名鼎鼎的商业软件“锐速”，相信很多人都清楚。特别是对于使用国外服务器或者VPS的人来说，效果更佳。网上有很多在 Debian 和 Ubuntu 系统下启用 BBR 的教程，我就不粘贴了，我自己一直用的是 CentOS，本文介绍一下在 64位 CentOS 7 系统下开启BBR的方法。 ...继续阅读 (8)

本文译自Matt Stauffer的系列文章.之前完全忘了要把这个 Laravel 5 的系列博客写完，不过最近看到了一篇关于属性转换的简介Laravel 5 Eloquent Attribute Casting is Awesome, 所以我决定把这个特性加到我的系列文章中。官方文档的 Eloquent 相关部分在这里。什么是属性转换转换一个属性值的意思是把它转换成某个特定的数据类型（或者是为了确保它是某个特定的数据类型）。数据类型我们都很熟悉了，比如integer或者boolean.属性转换是 Eloquent 模型的一个功能特性，这个特性让我们可以赋予 Eloquent 模型中的某个属性转换为一个特定的数据类型。提示：在以前版本中也可以这样做，但是必须为每个属性定义一个自动赋值的方法。而在新版本中可以通过单一的数组配置让模型自动完成这些工作。这意味着假如你的数据是以特定的格式存储在数据库中，而你在使用时需要的是另外一种格式，现在你可以配置 Eloquent 模型自动完成两种格式之间的转换工作。为什么要这样做？最常见的应用场景可能是：当你存储数字的时候——它们默认是返回字符串，但 Eloquent 属性转换可以帮你把字符串转换为integer,real,float或者double，当然还可以转换为boolean.但这就是全部了吗？当然不是。它是如何实现的？要应用属性转换这个功能 ...继续阅读 (29)

本文译自Matt Stauffer的系列文章.在以往版本的 Laravel 中，假如你想自定义错误页面——比如当用户访问不存在的页面时显示一张猫的 GIF 动画图片——你可能会通过 Google 进行搜索，然后找到Dries Vints 写的这个文档。在 Laravel 5 中，这个问题得到了改进。>>直达解决方案源代码解析在新版本的 Laravel 中，所以处理自定义错误和异常的代码都移到了app/Exceptions/Handler.php里。如果你读了之前的bring Whoops back, 你应该还记得就是通过这里的代码实现的。但阅读代码时你可能发现了，默认是这样处理的：/** * Render an exception into an HTTP response. * * @param \Illuminate\Http\Request $request * @param \Exception $e * @return \Illuminate\Http\Response */ public function render($request, Exception $e) { if ($this->isHttpException($e)) { ...继续阅读 (23)

本文译自Matt Stauffer的系列文章.创建一个事件及其处理程序，再把两者关联起来，或者创建一个命令及其处理程序，再把两者关联起来。有时候这看起来需要大量的工作。因此我经常期望能有一个工作流可以把所有这些工作整合在一起来处理。用来创建事件和命令的 Artisan 命令是一个很好的开始，它能同时创建命令或事件的实体并且同时生成它们的处理程序（可选的）。但编写命令和处理程序依然需要花费个把小时的时间，然后还得再花另外的 15 分钟来调试它们。或许花了大量的时间之后才发现问题其实只是因为你没有把它们绑定起来……输入 event:generate好在，我们的紧张等待终于结束了。在 Laravel 5 中，你可以在EventServiceProvider中绑定（不存在的）事件和处理程序，只要执行php artisan event:generate, Artisan 就会自动生成全部文件，包括事件和对应的处理程序。如何实现先看一下事件和处理程序的目录：app/ Events/ Event.php Handlers/ Events/1) 打开app/providers/EventServiceProvider.php, 找到$listen属性，通常情况下我们就在这里进行事件绑定，按照下面的格式添加一条绑定：protected $listen ...继续阅读 (14)

本文译自Matt Stauffer的系列文章.提示：如果你还没有看过Laravel 5.0 之命令及处理程序这篇文章，建议先看一下。它包括了本文所需的背景知识。借助 Laravel 5 的命令（及命令处理程序），你可以通过封装的方式非常简单、直接地向系统发出命令。DoThis.HandleACommandThatIsTellingMeToDoThis, 它是命令式的，告诉系统要做什么事。但有时候，不管是在命令结果中，还是在其它的上下文中，我们需要发出更抽象的通知。比如在 Laravel 4 中，可以直接以事件名称的字符串来触发事件（而不是像上面那样通过对象和方法）：$response = Event::fire('auth.login', array($user));这行代码向整个应用发出一条通知：“有人登陆了，这是用户信息”。它是知会式的，只是知会事件发生比提供相关信息。如果你熟悉“发布/订阅”概念的话，这就是“事件”机制要处理的。在 Laravel 5 中，事件系统已经得到了升级，看上去与上一篇文章中介绍过的命令系统有几分相似。在升级后的事件系统中，不是基于字符串来标识事件（比如 "auth.login"），而是创建一个 PHP 对象，并发布它。示例接下来，直接以例子来做说明：生成事件$ php artisan make:event ThingWasDone... 这行命令会生 ...继续阅读 (12)

本文译自Matt Stauffer的系列文章.本文中涉及的新功能都是关于 Commands 的，这些特性在 Laravel 旧版本中已经有了，但是在 Laravel 5.0 中变得更加好用了。本文中将会用到例子来自于我正在开发的一个叫做 SaveMyProposals 的新应用。什么是 Command, Command handler 和 Command bus?在Shawn McCool 的这篇文章中，你可以深入了解 command, command handler, command bus 的概念。但总的来说：Command 是一个代表信息的简单对象。它只包含你打算做某件事时需要用到的信息。在我们接下来的例子中，它就是 "复制谈话命令(Duplicate Talk Command)", 任何时候当用户要复制一条谈话建议时，我们的系统就会调用它。 这个 "重复谈话命令" 会包含复制一个谈话所需要的全部属性集——比如一个序列化的 Talk 对象或者是 TaldId.Command Handler 则是用于对 Command 做出响应的一个类。Command 可以在一个或多个 Handlers 之间传递， 每个 Handler 从 Command 中取出重要的信息并做某些操作来响应。Command bus 是一套用于调度 Commands 的系统。它把 commands 与对应的 H ...继续阅读 (31)

本文译自Matt Stauffer的系列文章.关于 Laravel 5.0 的事件调度程序（可以理解为定时任务），Eric Barnes 有一篇很长的文章。我这篇文章则会尽量简短：Laravel 5.0 新增了一个框架内置的 cron 风格的令人难以置信的调度程序（与Indatus 的 Dispatcher类似）。只要在服务器上设置一个每分钟调用artisan schedule:run的 cron job, 一切就准备就绪了。*/1 * * * * php /path/to/artisan schedule:run举个例子，通过绑定下面的事件，可以实现每天自动清理密码提示记录：$schedule ->command('auth:clear-reminders') // 清理密码提示 ->daily() // 每天执行 ->sendOutputTo($logPath) // 把输出写入日志 ->emailOutputTo('me@me.com'); // 把输出发到指定邮箱你可以通过command()来调用 artisan 命令,call来调用方法或函数， 或者terminal()来执行单行命令脚本：$schedule->call('YourClass@someMethod')->twiceDaily(); $schedule->call(funct ...继续阅读 (30)

本文译自Matt Stauffer的系列文章.如果你关注我的博客有段时间了，那你应该曾经见过我在 Laravel 环境检测问题上的各种尝试，特别使用环境变量进行检测这方面。例子感谢 Laravel 5, 它极大地简化了环境检测环节。在 4.x 版的时候，你要创建多个基于运行环境名称的环境配置文件（比如.env.php,.env.local.php等）。老实说，我从来用过这个功能。但我觉得理论上你应该会把所有环境配置文件提交到代码库。但由于我们从来不提交任何环境配置文件，所以这种区分环境的手段毫无用处，而且它还会造成环境配置文件的延迟加载，因为只有检测到运行于什么环境之后，它才能进行相应的配置文件加载。PHP dotenv 介绍Laravel 5.0 其实也没做什么特别的创新，它只是使用了PHP dotenv, 一个从单一.env文件中加载环境配置的第三方库。新版本的 Laravel 初始框架包含一个默认的.env.example文件，这个文件暂时看起来长这样：APP_ENV=local APP_KEY=SomeRandomString DB_USERNAME=homestead DB_PASSWORD=homestead要使用这个功能，只需要复制这个文件并重命名为.env(类似 wordpress 的 wp-config-sample.php). 为什么不直接重命名原始文件而是先复 ...继续阅读 (21)

本文译自Matt Stauffer的系列文章.如果你有阅读我之前的 Laravel 5.0 系列文章，你可能已经注意到路由过滤器(route filters)的变化：它们先是移到了单独的目录和类结构，然后就莫名其妙地消失了。你可能还留意到在原本应该是路由过滤器的地方，变成了对 Middleware 的引用。实际上给 Laravel 应用添加自定义的 Middleware 在以前的版本中就有了。 Chris Fidao 的HTTP Middleware in Laravel 4.1对 middleware 做了全面的介绍，包括 middleware 在 Laravel 4.1 版本中的工作机制。提示：过滤器在 Laravel 核心代码中依然存在，所以你依然可以使用。但是在需要对路由进行修饰时，更推荐采用的是 middleware.Middleware 是什么？Middleware 有点不好理解。你可以先看看下面这张从StackPHP借来的图。假设你的应用——路由，控制器，业务逻辑——是图中的绿色部分，从图中可以清晰地看到，用户请求先经由多个中间层才能到达你的应用，然后再经由更多的中间层进行处理。每个特定的中间层都可以在应用逻辑之前、之后进行处理，或者同时在应用逻辑之前和之后进行处理。这就是 middleware 实现修饰模式的工作方式：它捕获请求，做一些处理，然后把处理后的请求对象返 ...继续阅读 (24)

本文译自Matt Stauffer的系列文章.Laravel 5.0 中, 容器可以对其解析的方法进行自动分析, 然后根据类型限制把方法所需要的依赖项自动注入. 本文将介绍这一机制的原理, 何时解析, 如何注入等.依赖注入的背景知识在现代编程实践中, PHP 开发者要学会的首要知识之一就是使用依赖注入. 这就是 SOLID(单一功能,开闭原则,里氏替换,接口隔离以及依赖反转) 中的依赖反转(Dependency Inversion).Laravel 的容器被称为 IOC(Inversion of Control) 容器, 之所以如此命名, 是因为它允许开发者掌控应用底层所发生的事件: 在顶层代码(controllers, 扩展类等)中请求一个实例, 比如 "mailer", 容器就会返回一个 "mailer" 的实例. 这样, 顶层代码不关注底层到底是由哪个服务来发送邮件--不管是 Mandrill, Mailgun 还是 SendMail, 都不重要, 因为所有 mailer 类都实现相同的接口.Laravel 4 中的构造函数注入下面是一个以前的依赖注入的示例:... class Listener { protected $mailer; public function __construct(Mailer $mailer) { $th ...继续阅读 (24)

本文译自Matt Stauffer的系列文章.在 Laravel 5.0 版本中, FileSystem 类不再只是与本地文件系统进行交互, 而是可以用于 S3 和 Rackspace 的存储 API, 但使用方法很简单. 这是基于Frank de Jonge的Flysystem实现的一个简单的接口.这意味着开发者可以像从前操作本地文件存储那样编写代码:/** * 存储 Thing 到文件中 * * @param Thing $thing * @param string $filename */ public function saveThing(Thing $thing, $filename) { File::put('uploads/' . $filename, $thing); }在 Laravel 5.0 中, 可以随时通过修改生产环境下的应用配置文件, 无缝切换到外部的云存储服务(目前仅支持 S3 和 Rackspace, 本文以 S3 为例), 无需对上面的代码做任何修改.从本地存储切换到 S3 服务.首先, 需要在 composer.json 文件中添加云服务提供商的依赖项. 以 S3 为例, 依赖项是 AWS SDK(aws\aws-sdk-php).$ composer require aws\aws-sdk-php然后, 修改config/f ...继续阅读 (22)