Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/globaltradingtechnologies/thriftgenerator
Generates .thrift definition files based on php classes signatures
https://github.com/globaltradingtechnologies/thriftgenerator
Last synced: 10 days ago
JSON representation
Generates .thrift definition files based on php classes signatures
- Host: GitHub
- URL: https://github.com/globaltradingtechnologies/thriftgenerator
- Owner: GlobalTradingTechnologies
- License: mit
- Created: 2014-11-10T17:55:33.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2020-03-09T04:26:52.000Z (almost 5 years ago)
- Last Synced: 2024-11-16T04:52:37.752Z (about 1 month ago)
- Language: PHP
- Homepage:
- Size: 90.8 KB
- Stars: 5
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
ThriftGenerator
===============
Generates [apache thrift](http://thrift.apache.org/) definition files based on PHP classes signature.
[](https://travis-ci.org/GlobalTradingTechnologies/ThriftGenerator)
[](https://scrutinizer-ci.com/g/GlobalTradingTechnologies/ThriftGenerator/?branch=master)
[](https://scrutinizer-ci.com/g/GlobalTradingTechnologies/ThriftGenerator/?branch=master)
[](https://packagist.org/packages/gtt/thrift-generator)
[](https://packagist.org/packages/gtt/thrift-generator)
[](https://packagist.org/packages/gtt/thrift-generator)
What's the purpose?
===================
The main apache thrift's concept is to make possible cross-language services development that can interact with each other.
In order to product code that can be invoked remotely using thrift framework you need firstly provide all target classes
definitions in special [thrift](http://thrift.apache.org/docs/idl) files and then generate service thrift code.
But imagine you already have some server classes and you want to provide some RPC API for them using thrift. In this case manual filling of thrift files for those server classes seems to be annoying.
ThriftGenerator uses class reflection and doc-blocks to introspect class signatures and generate corresponding thrift files automatically for you. This thrift files would be used then to generate thrift service stuff that can be used on server side with the help of original thrift compiler.
Requirements
===================
ThriftGenerator works with PHP classes and requires PHP 5.3 or higher and provides thrift definition files
can be used by thrift compiler 0.9.2 and higher.
Installation
===================
ThriftGenerator can be installed with composer quite easy:
```
composer require gtt/thrift-generator 0.1.0
```
You also can use ThriftGenerator as a standalone library:
```
git clone https://github.com/GlobalTradingTechnologies/ThriftGenerator && cd ThriftGenerator
composer install --prefer-dist
```
Usage
===================
ThriftGenerator has handy OOP interface:
```php
use Gtt\ThriftGenerator\Generator\ThriftGenerator;
$generator = new ThriftGenerator();
$generator
// set classes that should be introspected in order to generate thrift definition files
->setClasses(
array(
new ReflectionClass("\Your\Class\Name"),
new ReflectionClass("\Another\Class\Name")
)
)
// set output dir
->setOutputDir("")
// generate!
->generate();
```
See also [demos](demos) and [functional test cases](tests/Fixtures) for more details.
Restrictions
===================
Sinсe ThriftGenerator statically introspects PHP class signature only with use of Reflection functionality so it have no chance to detect and define in thrift IDL any classes that is used
internally in your classes (in most cases that is not described in class doc-blocks as input params,
return values or exceptions can be thrown).
Roadmap
===================
It would be nice to have some features that are not implemented yet:
1. Support of relative complex type/exception names (not FQCN's) in doc blocks.
2. Thrift service inheritance support.
3. Comments in generated thrift files.
4. Custom doc-block's implementation to support some thrift-related options that can not be reflected from PHP method signatures or doc blocks (container types wide support, one-way calls, enum's and etc).
5. Thrift versioning support.