• Shuhei Taunma's avatar
    (PHP) add experimental support for PHP language. · 5ce86826
    Shuhei Taunma authored
    * codegen for all basic features: WIP (probably implemented all basic feature)
    * JSON parsing: NO
    * Simple mutation: NO
    * Reflection: NO
    * Buffer verifier: NO (will be add later)
    * Testing: basic: Yes
    * Testing: fuzz: Yes
    * Performance: Not bad
    * Platform: Supported Linux, OS X, Windows (has 32bit integer limitation)
    * Engine Unity: No
    
    flatc --php monster_test.fbs
    
      <?php
      //include neccessary files.
      $fbb = new Google\FlatBuffers\FlatBufferBuilder(1);
      $str = $fbb->createString("monster");
      \MyGame\Example\Monster::startMonster($fbb);
      \MyGame\Example\Monster::addHp($fbb, 80);
      \MyGame\Example\Monster::addName($fbb, $str);
      $mon = \MyGame\Example\Monster::endMonster($fbb);
      $fbb->finish($mon);
      echo $fbb->sizedByteArray();
    
    PHP 5.4 higher
    
    Currently, we do not register this library to packagist as still experimental and versioning problem.
    If you intended to use flatbuffers with composer. add repostiories section to composer.json like below.
    
      "repositories": [{
        "type": "vcs",
        "url": "https://github.com/google/flatbuffers"
      }],
    
     and just put google/flatbuffers.
    
      "require": {
        "google/flatbuffers": "*"
      }
    
    * PHP's integer is platform dependant. we strongly recommend use 64bit machine
      and don't use uint, ulong types as prevent overflow issue.
      ref: http://php.net/manual/en/language.types.integer.php
    
    * php don't support float type. floating point numbers are always parsed as double precision internally.
      ref: http://php.net/manual/en/language.types.float.php
    
    * ByteBuffer is little bit slow implemnentation due to many chr/ord function calls. Especially encoding objects.
      This is expected performance as PHP5 has parsing arguments overhead. probably we'll add C-extension.
    
    Basically, PHP implementation respects Java and C# implementation.
    
    Note: ByteBuffer and FlatBuffersBuilder class are not intended to use other purposes.
          we may change internal API foreseeable future.
    
    PSR-2, PSR-4 standards.
    
    Implemented simple assertion class (respect JavaScript testcase implementation) as we prefer small code base.
    this also keeps CI iteration speed.
    
    we'll choose phpunit or something when the test cases grown.
    5ce86826
Name
Last commit
Last update
CMake Loading commit data...
android Loading commit data...
biicode Loading commit data...
build Loading commit data...
docs Loading commit data...
go Loading commit data...
include/flatbuffers Loading commit data...
java Loading commit data...
js Loading commit data...
net/FlatBuffers Loading commit data...
php Loading commit data...
python Loading commit data...
reflection Loading commit data...
samples Loading commit data...
src Loading commit data...
tests Loading commit data...
.gitattributes Loading commit data...
.gitignore Loading commit data...
.travis.yml Loading commit data...
CMakeLists.txt Loading commit data...
CONTRIBUTING.md Loading commit data...
LICENSE.txt Loading commit data...
biicode.conf Loading commit data...
composer.json Loading commit data...
readme.md Loading commit data...