包简介

Permify is an open source authorization service for creating fine-grained and scalable authorization systems.

README 文档

README

Permify is an open source authorization service for creating fine-grained and scalable authorization systems.

For more information, please visit https://github.com/Permify/permify/issues.

Installation & Usage

Requirements

PHP 7.4 and later. Should also work with PHP 8.0.

Composer

To install the bindings via Composer, add the following to composer.json:

{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/GIT_USER_ID/GIT_REPO_ID.git"
    }
  ],
  "require": {
    "GIT_USER_ID/GIT_REPO_ID": "*@dev"
  }
}

Then run composer install

Manual Installation

Download the files and include autoload.php:

<?php
require_once('/path/to/permify-php/vendor/autoload.php');

Getting Started

Please follow the installation procedure and then run the following:

<?php
require_once(__DIR__ . '/vendor/autoload.php');




$apiInstance = new Permify\Api\BundleApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
    new GuzzleHttp\Client()
);
$tenant_id = 'tenant_id_example'; // string | Identifier of the tenant, if you are not using multi-tenancy (have only one tenant) use pre-inserted tenant <code>t1</code> for this field. Required, and must match the pattern \\“[a-zA-Z0-9-,]+\\“, max 64 bytes.
$body = new \Permify\Model\BundleDeleteBody(); // \Permify\Model\BundleDeleteBody

try {
    $result = $apiInstance->bundleDelete($tenant_id, $body);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling BundleApi->bundleDelete: ', $e->getMessage(), PHP_EOL;
}

API Endpoints

All URIs are relative to http://localhost

Class	Method	HTTP request	Description
BundleApi	bundleDelete	POST /v1/tenants/{tenant_id}/bundle/delete	delete bundle
BundleApi	bundleRead	POST /v1/tenants/{tenant_id}/bundle/read	read bundle
BundleApi	bundleWrite	POST /v1/tenants/{tenant_id}/bundle/write	write bundle
DataApi	bundleRun	POST /v1/tenants/{tenant_id}/data/run-bundle	run bundle
DataApi	dataAttributesRead	POST /v1/tenants/{tenant_id}/data/attributes/read	read attributes
DataApi	dataDelete	POST /v1/tenants/{tenant_id}/data/delete	delete data
DataApi	dataRelationshipsRead	POST /v1/tenants/{tenant_id}/data/relationships/read	read relationships
DataApi	dataWrite	POST /v1/tenants/{tenant_id}/data/write	write data
DataApi	relationshipsDelete	POST /v1/tenants/{tenant_id}/relationships/delete	delete relationships
DataApi	relationshipsWrite	POST /v1/tenants/{tenant_id}/relationships/write	write relationships
PermissionApi	permissionsBulkCheck	POST /v1/tenants/{tenant_id}/permissions/bulk-check	bulk check api
PermissionApi	permissionsCheck	POST /v1/tenants/{tenant_id}/permissions/check	check api
PermissionApi	permissionsExpand	POST /v1/tenants/{tenant_id}/permissions/expand	expand api
PermissionApi	permissionsLookupEntity	POST /v1/tenants/{tenant_id}/permissions/lookup-entity	lookup entity
PermissionApi	permissionsLookupEntityStream	POST /v1/tenants/{tenant_id}/permissions/lookup-entity-stream	lookup entity stream
PermissionApi	permissionsLookupSubject	POST /v1/tenants/{tenant_id}/permissions/lookup-subject	lookup-subject
PermissionApi	permissionsSubjectPermission	POST /v1/tenants/{tenant_id}/permissions/subject-permission	subject permission
SchemaApi	schemasList	POST /v1/tenants/{tenant_id}/schemas/list	list schema
SchemaApi	schemasPartialWrite	PATCH /v1/tenants/{tenant_id}/schemas/partial-write	partially update your authorization model
SchemaApi	schemasRead	POST /v1/tenants/{tenant_id}/schemas/read	read schema
SchemaApi	schemasWrite	POST /v1/tenants/{tenant_id}/schemas/write	write schema
TenancyApi	tenantsCreate	POST /v1/tenants/create	create tenant
TenancyApi	tenantsDelete	DELETE /v1/tenants/{id}	delete tenant
TenancyApi	tenantsList	POST /v1/tenants/list	list tenants
WatchApi	watchWatch	POST /v1/tenants/{tenant_id}/watch	watch changes

Models

Authorization

Authentication schemes defined for the API:

ApiKeyAuth

Type: API key
API key parameter name: Authorization
Location: HTTP header

Tests

To run the tests, use:

composer install
vendor/bin/phpunit

Author

hello@permify.co

About this package

This PHP package is automatically generated by the OpenAPI Generator project:

API version: v1.5.4
- Package version: v1.5.4
Build package: org.openapitools.codegen.languages.PhpClientCodegen

permify/permify-php 适用场景与选型建议

permify/permify-php 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 10 次下载、GitHub Stars 达 3，最近一次更新时间为 2026 年 01 月 15 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「php」「rest」「api」「sdk」「openapi」「openapitools」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 permify/permify-php 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 permify/permify-php 我们能提供哪些服务？

定制开发 / 二次开发

基于 permify/permify-php 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 permify/permify-php 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

theodorejb/phaster 6

A PSR-7 compatible library for making CRUD API endpoints

braune-digital/api-base-bundle 0

Api bundle

foxtes/alfabank-rest 1

Alfabank REST API integration

intahwebz/flickrguzzle 4

A Flickr wrapper to allow you to call the Flickr api with Guzzle as the backend.Goal is to have 100% Flickr api coverage rather than just upload/display photos (currently at 23%).

gego-soft/php-client 0

BlockCypher's PHP SDK for REST API

wellrested/cookies 0

Helper classes for creating cookie headers

permify/permify-php

包简介

关键字：