一次 Linux 升级引发的“全员禁登”血案：从 PAM 损坏到 RPM 诡异 ELOOP 报错的深度复盘
最近在一台腾讯云服务器上做例行维护：清理了一批不再使用的历史软件包，顺手升级了基础组件与内核。重启之后，机器网络通畅、业务容器也都在正常跑着，但诡异的事情发生了：无论是 SSH 密钥登录，还是腾讯云控制台的 VNC 账号密码登录，全部被拒绝。
整台机器仿佛变成了一座“看得见却进不去”的孤岛。就在几乎要走挂载救援盘修文件的最坏打算时，腾讯云的 TAT（自动化助手）免密登录通道 成了力挽狂澜的救命稻草。借着这个最后的窗口，展开了一场层层反转的排障。
我在写“Spiral 详细上手指南”的过程其实是一边做官方文档的翻译，一边验证英文版教程中内容的正确性，一边写的。而且涉及到每一个模块和组件，除了在演示项目中简单应用之外，一般还要顺便把该组件做比较全面详细地介绍。以致于进度就非常慢了。考虑到读者“快速上手”的需求，正好官方文档的“快速开始”文档也完成了，干脆我先把官方的快速开始文档（一个简单但完整的项目实战）翻译好发出来，以满足读者快速上手的需求。至于“Spiral 详细上手指南”，还会随着我的进度慢慢推进。
这篇教程很长，有四万多字，建议读者跟着教程一步一步地动手，到最终完成演示项目时，也就基本掌握了 Spiral 的开发流程。我在翻译这篇文档的时候，也是操作一步，翻译一步，中间发现官方文档的错误或者有遗漏的步骤时，都先提交 PR 修复了英文文档。
文档中有大量指向其它文档的链接，所有已经完成翻译的，我都指向了中文文档的地址，还没有完成翻译的，只能先指向英文文档。
Spiral 详细上手指南系列文章的代码托管在 gitee 仓库，每一篇文章结束时的代码都会在一个单独的分支下，本篇文章对应的代码分支是 step-3.
在上一篇《Spiral 详细上手指南之路由规则》中，相信大家对于 Spiral 框架中的路由配置已经完全掌握了。不过在文章结束的时候，我们创建的控制器针对各种请求只是简单地响应一串文字证明路由生效了。这次我们就来实现其中的文章列表和文章详情。
本文首发于云加社区我的个人专栏。受云加社区协议限制，未经许可不得转载。关于 Spiral 框架的这个系列文章，都会首发云加社区，之后过一段时间才会同步到个人博客。
在上一篇《Spiral 详细上手指南之安装与配置》中，我们已经基于官方的 WEB 项目模板创建了自己的本地项目 "myapp" 并且已经配置好了数据库连接和用于开发的进程参数。
通过这整个系列，最终将会开发完成一个简化版的博客 APP. 在这次的文章中，暂时不会涉及数据库操作和领域模型相关的开发，而是聚焦于 Spiral 框架的路由（route）和控制器（controller）部分。
本文首发于云加社区我的个人专栏。受云加社区协议限制，未经许可不得转载。关于 Spiral 框架的这个系列文章，都会首发云加社区，之后过一段时间才会同步到个人博客。
在上一篇《Spiral: 一个性能卓越的PHP/Golang混合开发框架》 中，我介绍了 Spiral 这个基于 PHP/Golang 的高性能混合开发框架，这次开始这个上手指南系列的第一篇文章。
本文首发于云加社区我的个人专栏。受云加社区协议限制，未经许可不得转载。关于 Spiral 框架的这个系列文章，都会首发云加社区，之后过一段时间才会同步到个人博客。
春节期间，了解到一个“全新”的 WEB 开发框架：Spiral, 最开始引起我的兴趣是从同事那里听说了 RoadRunner. 然后去了解 RoadRunner 的时候看到了 Spiral. 之所以把“全新”用双引号引起来，是因为这个框架其实从 2013 年起就在它的开发团队以及一些企业客户中应用了，经历了各种实际应用场景的考验，Spiral 的功能及其丰富，性能与当前主流的 PHP 框架相比也相当出众。但这个框架源自白俄罗斯，在国内不算知名，他们团队开始重视和梳理开源，也应该是才开始的事情。
之前在公司的问答平台上解答了一个有关 git 多个远程仓库需要制定不用用户名或者用户邮箱的问题。原本以为是随口一答的问题，没想到之后该回答连续几个月一直有新增的点赞，说明会遇到这个问题的人还不少。所以把答案整理一下也发在博客一份。
最近发现 iTerm2 下的 $PATH 变量里出现重复的几组路径（npm, composer, go 相关的），一开始以为是重复定义了，排查了半天发现不是。上网搜了一下，找到一个解决方案：
在 ~/.zshrc 文件中最后一次 export PATH之后加入一行：
typeset -aU path这样 $PATH 变量里的所有路径就都是唯一的了。