Anax proxy is a module for static proxy to access framework resources, services, that are available in $di
service container.
The basic idea is to allow static access like this Session::start()
. You can see it as a wrapper above the ordinary way using $di->get("session")->start()
. It is syntactic sugar.
You can compare it to the implementation of Laravel Facade.
You can also read this documentation online.
You can install the module from anax/proxy
on Packagist using composer.
composer require anax/proxy
To work as a developer you clone the repo and install the local environment through make. Then you can run the unit tests.
make install
make test
You start by initiating the proxy factory in the frontcontroller index.php
.
use Anax\Proxy\ProxyDIFactory;
// Add all framework services to $di
$di = new Anax\DI\DIFactoryConfig();
$di->loadServices(ANAX_INSTALL_PATH . "/config/di");
// Add anax/proxy access to $id, if available
ProxyDIFactory::init($di);
Or like this to take into account if the module is installed or not.
// Add anax/proxy access to $id, if available
if (class_exists("\Anax\Proxy\ProxyDIFactory")) {
\Anax\Proxy\ProxyDIFactory::init($di);
}
The service container $di
is injected and an autoloader is created to catch and dynamic create classes for the proxy class to map the service in $di
.
You start by defining the proxy service class through its service name, like this.
use \Anax\Proxy\DI\Db;
You can then use it through static access Db::connect()
which behind the scenes translates to $di->get("db")->connect()
.
This is how it can be used with a route.
use \Anax\Proxy\DI\Db;
use \Anax\Proxy\DI\Router;
use \Anax\Proxy\DI\View;
use \Anax\Proxy\DI\Page;
/**
* Show all movies.
*/
Router::get("movie", function () {
$data = [
"title" => "Movie database | oophp",
];
Db::connect();
$sql = "SELECT * FROM movie;";
$res = Db::executeFetchAll($sql);
$data["res"] = $res;
View::add("movie/index", $data);
Page::render($data);
});
Here is the same route implemented, with $app
style programming and dependency to the (globaly) scoped variable $app
which is a front for $di
.
/**
* Show all movies.
*/
$app->router->get("movie", function () use ($app) {
$data = [
"title" => "Movie database | oophp",
];
$app->db->connect();
$sql = "SELECT * FROM movie;";
$res = $app->db->executeFetchAll($sql);
$data["res"] = $res;
$app->view->add("movie/index", $data);
$app->page->render($data);
});
Above example uses $app
which itself does a $di->get("service")
behind the scene.
So, it is a matter of syntactic sugar, a layer of user friendliness you might approve of, or not.
Laravel have an implementation as Laravel Facade. This might indicate they relate to the design pattern Facade design pattern
.
People have argued that the implementation is more of the design pattern Proxy design pattern
.
People have also argued that it is an implementation of the design pattern Singleton design pattern
.
Using psr11 through psr/container
.
This software carries a MIT license. See LICENSE.txt for details.
.
..: Copyright (c) 2018 Mikael Roos, mos@dbwebb.se