Slim是一个我很喜欢用的轻框架，我用它为我的任氏有无轩站点提供API服务。这几天趁着放假，想重新“折腾”一下我的站点，于是就开了一个虚拟机，装好了必要的软件，准备开发。
然后我发现，Slim这个框架已经升级到了4，有了重大的变化。
参照Slim官方说明创建项目后，目录结构如下（请忽略其中的nbproject目录）：
return function (ContainerBuilder $containerBuilder) {
$containerBuilder->addDefinitions([
...
PDO::class => function (ContainerInterface $c) {
$settings=$c->get('settings')['db'];
$host=$settings['host'];
$user=$settings['user'];
$pass=$settings['pass'];
$db=$settings['db'];
$dsn="mysql:host=$host;dbname=$db";
$conn=new PDO($dsn, $user, $pass);
$conn->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
return $conn;
},
]);
};
注意，我在这里设置了数据库PDO链接的一些属性。以后在应用的任何地方，只要用到PDO这个类的声明，Slim都会在容器中去寻找PDO的实例，从而保证所有的数据库链接都是统一的。
middleware.php：中间件我目前在API中还不会用到。按照Slim的说明，中间件可以在应用前和后运行，修改相应的Request和Response对象。repositories.php：这里注册所有可以成为“仓库”的类。这是Slim 4新增的文件，用来统一管理MVC中的M；但Slim 4抛弃了M，而改用更轻量的仓库。这也是一个容器。如：
declare(strict_types=1);
use App\Domain\Book\BookRepository;
use App\Infrastructure\Persistence\Book\DBBookRepository;
use DI\ContainerBuilder;
return function (ContainerBuilder $containerBuilder) {
$containerBuilder->addDefinitions([
BookRepository::class => \DI\autowire(DBBookRepository::class),
]);
};
注：这里用到的一些类会在后续得到说明。不过可以提醒一下，Slim 4用一个接口（BookRepository）定义所有该仓库支持的操作，而用一个实例类（DBBookRepository）对这个接口进行实现。你可以把它们的这种关系类比成C++中的“hpp/cpp”的关系。
routes.php：这是常规的路由配置。请注意，Slim4放弃了一个controller中多个action的做法，而是一个action对应一个controller，如下例所示：
declare(strict_types=1);
use Psr\Http\Message\ResponseInterface as Response;
use Psr\Http\Message\ServerRequestInterface as Request;
use Slim\App;
use Slim\Interfaces\RouteCollectorProxyInterface as Group;
use App\Application\Actions\Index\IndexAction;
use App\Application\Actions\Book;
return function (App $app) {
$app->get('/', IndexAction::class);
$app->group('/summary', function(Group $group) {
$group->get('', Book\SummaryAction::class);
});
};
于是，/summary这个路由就会调用Book\SummaryAction::class中制定的action函数。
settings.php：全局配置文件。数据库的配置也在此处出现：
return function (ContainerBuilder $containerBuilder) {
// Global Settings Object
$containerBuilder->addDefinitions([
'settings' => [
'displayErrorDetails' => true, // Should be set to false in production
'logger' => [
'name' => 'slim-app',
'path' => isset($_ENV['docker']) ? 'php://stdout' : __DIR__ . '/../logs/app.log',
'level' => Logger::DEBUG,
],
//Database connection
'db' => [
'host' => 'localhost',
'user' => '****',
'pass' => '****',
'db' => '****',
],
],
]);
};
总结：app目录中的，都是对应用全局产生影响的文件。
public目录：这里是应用的入口文件。一般情况下，对于一个API应用来说，这里没有什么需要修改的。src/Application目录：这里有四个目录。我们重点要关注的是src/Application/Actions目录。
根据我的理解，针对API要成立的各类实体，开发者可以进行逻辑抽象分类，形成各个action。在具体实现的时候，一般是针对每个实体实现一个抽象的类，然后对每个针对这个实体的操作定义一个action。
比如我的数据库中有“书籍（book）”这个实体，于是我就暂时定义了两个文件：BookAction.php和SummaryAction.php。
//BookAction.php
declare(strict_types=1);
namespace App\Application\Actions\Book;
use App\Application\Actions\Action;
use App\Domain\Book\BookRepository;
use Psr\Log\LoggerInterface;
use Psr\Http\Message\ResponseInterface as Response;
abstract class BookAction extends Action
{
/**
* {@inheritdoc}
*/
protected $repo;
public function __construct(BookRepository $repo, LoggerInterface $logger) {
parent::__construct($logger);
$this->repo=$repo;
}
}
注意到，这是一个抽象类，主要目的是为本类（以及后续子类）引入各种dependency。这里我引入了BookRepository和LoggerInterface。
//SummaryAction.php
declare(strict_types=1);
namespace App\Application\Actions\Book;
use Psr\Http\Message\ResponseInterface as Response;
class SummaryAction extends BookAction
{
/**
* {@inheritdoc}
*/
protected function action(): Response
{
$res=$this->repo->summary();
return $this->respondWithData($res);
}
}
SummaryAction继承了BookAction，完成了action方法。而在action方法中，通过调用repo中对应的方法而获取了数据并返回。Slim4很贴心地可以直接返回json数据，不用开发者再转换。调用的例子如下：
我们再来看src/Domain目录。
这个目录中包括用来定义各类仓库的文件。比如我们之前看到的BookRepository：
// /src/Domain/Book/BookRepository.php
declare(strict_types=1);
namespace App\Domain\Book;
interface BookRepository
{
public function summary(): array;
public function detail($id):array;
}
如前所述，这是一个接口，只是定义了各类接口，也就是这个仓库能做什么的定义。
最后来看看src/Infrastructure/Persistence目录。这个目录对上面提到的接口进行实现。
// /src/Infrastructure/Persistence/Book/DBBookRepository.php
declare(strict_types=1);
namespace App\Infrastructure\Persistence\Book;
use App\Domain\Book\BookRepository;
class DBBookRepository implements BookRepository
{
private $conn;
public function __construct(\PDO $conn) {
$this->conn=$conn;
}
public function summary(): array {
$sql='select count(*) bc, sum(kword) wc, sum(page) pc from book_book';
$res=$this->conn->query($sql)->fetch();
return $res;
}
public function detail($id): array {
}
}
请注意，这个类的构造函数中引入了\PDO，因此上文提到的dependency就起作用了。
总体感觉，Slim 4的结构还是很清晰的，耦合度也合适，确实是可以一用的轻量级框架。
本文推送到[go4pro.org]。
