Home

Awesome

PHP Accessor

生成类访问器(Getter & Setter)

快速入门

安装

composer require free2one/php-accessor

项目composer.json 文件中配置以下信息

{
  "scripts":{
    "php-accessor": "@php vendor/bin/php-accessor generate"
  }
}

将相应的注释添加到需要生成访问器的类中:

<?php
namespace App;

use PhpAccessor\Attribute\Data;

#[Data]
class Entity
{
    private int $id;

    private string $name;
}

运行命令生成代理类

composer run-script php-accessor CLASS_PATH

注解说明

#[Data]

用于PHP Accessor识别是否需要生成访问器。

配置项

namingConvention: 访问器命名约定,支持以下类别

accessorType: 需要生成的访问器类型

prefixConvention: 访问器前缀约定,支持以下类别

示例

<?php

namespace App;

use PhpAccessor\Attribute\Data;
use PhpAccessor\Attribute\Map\NamingConvention;

#[Data(namingConvention: NamingConvention::UPPER_CAMEL_CASE, accessorType: AccessorType::GETTER)]
class Entity
{
    private int $id;

    private string $name;
}

#[Overlook]

设置后该类字段将不生成访问器。

示例

<?php

namespace App;

use PhpAccessor\Attribute\Data;
use PhpAccessor\Attribute\Overlook;

#[Data]
class Entity
{
    private int $id;

    #[Overlook]
    private string $ignore;
}

#[DefaultNull]

设置后调用相应的Getter方法时,若属性未进行初始化,将返回null。

示例

<?php

namespace App;

use PhpAccessor\Attribute\Data;
use PhpAccessor\Attribute\DefaultNull;

#[Data]
class Entity
{
    private int $id;

    #[DefaultNull]
    private string $defaultNull;
}

$entity = new Entity();
var_dump($entity->getDefaultNull());  // output: NULL

要点说明

如何使用生成的代理类

如果你的项目使用的是Hyperf框架,则可直接引入<a href="https://github.com/kkguan/hyperf-php-accessor">Hyperf PHP Accessor</a>包。其他情况下,请参考以下示例。

待生成访问器的类Entity

<?php

namespace App;

use PhpAccessor\Attribute\Data;
use PhpAccessor\Attribute\Overlook;

#[Data()]
class Entity
{
    #[Overlook]
    private string $ignore;

    private int $id;
}

执行文件示例

<?php

require_once "vendor/autoload.php";

use App\Entity;
use Composer\Autoload\ClassLoader;
use PhpAccessor\Console\Application;
use Symfony\Component\Console\Input\ArrayInput;
use Symfony\Component\Finder\Finder;

$scanDir = ['PROJECT_ROOT_PATH/app']; //需要扫描的项目目录
$proxyDir = 'PROJECT_ROOT_PATH/.php-accessor'; //代理类存放目录

//生成代理类
$input = new ArrayInput([
    'command' => 'generate',
    'path' => $scanDir,
    '--dir' => $proxyDir,
    '--gen-meta' => 'yes',  //发布线上时,可设置为no
    '--gen-proxy' => 'yes',
]);
$app = new Application();
$app->setAutoExit(false);
$app->run($input);

//利用composer注册自动加载
$finder = new Finder();
$finder->files()->name('*.php')->in($proxyDir);
$classLoader = new ClassLoader();
$classMap = [];
foreach ($finder->getIterator() as $value) {
    $classname = str_replace('@', '\\', $value->getBasename('.' . $value->getExtension()));
    $classname = substr($classname, 1);
    $classMap[$classname] = $value->getRealPath();
}
$classLoader->addClassMap($classMap);
$classLoader->register(true);

//Entity已被替换为代理类😸
$entity = new Entity();
$entity->setId(222);
var_dump($entity);

相关资源

<a href="https://github.com/kkguan/php-accessor">PHP Accessor</a>: 访问器生成器

<a href="https://github.com/kkguan/php-accessor-idea-plugin">PHP Accessor IDEA Plugin</a>: Phpstorm插件,文件保存时自动生成访问器.支持访问器的跳转,代码提示,查找及类字段重构等.

<a href="https://github.com/kkguan/hyperf-php-accessor">Hyperf PHP Accessor</a>: Hyperf框架SDK

<a href="https://github.com/kkguan/laravel-php-accessor">Laravel PHP Accessor</a>: Laravel框架SDK