2017 © Pedro Peláez
 

library annotation

this library parse php annotation

image

saberyjs/annotation

this library parse php annotation

  • Sunday, March 11, 2018
  • by saberyjs
  • Repository
  • 1 Watchers
  • 1 Stars
  • 10 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 4 Versions
  • 0 % Grown

The README.md

why need this library

if you have used ReflectionClass or ReflectionMethod of php,you will find that there is a method called getDocComment ,it means that we can get comment of specified class (and method of class),so,we can do something with it. do you remember Java web Annotation ?? it is a powerful develop tool,but ,this library do not that,it on parse comment,because we never know what you want to do,right ??, (*1)

how to use

this library support two function ,as follows:, (*2)

get doc comment

firstly we assume there is class called Student:, (*3)

class  Student{
    /**
     * @type post
     * @https true
     * **/
    public function  getName(){
        return '';
    }
}

$doc=\saberyjs\annotation\Annotation::getAnnotation();

Annotation::getAnnotation() return a raw string, (*4)

parse comment

before we get into real code,we must understand that there is a concept called parser,each kind of parser must implement interface called Parser, the interface is very simple,i will show you the code:, (*5)

namespace  saberyjs\annotation;

interface  Parser {
    /**
     * @param  $doc string
     * @return  array|null
     * **/
    public function parse($doc);
}

every parser must implement parse method,it is the only method,this library has two internal parser ,StandardAnnotationParser and PlainAnnotationParser,of course,you can write your own parser(must implement Parser interface) whenever you want . if you use StandardAnnotationParser,code as follows:, (*6)

$doc=\saberyjs\annotation\Annotation::getAnnotation(Student::class);
$parser=new \saberyjs\annotation\StandardAnnotationParser();
$parts=\saberyjs\annotation\Annotation::parseAnnotation($doc,$parser);

if you remember the class called Student,you will find that it has a method called getName,the method has some comment,we paste it here, (*7)

/**
     * @type post
     * @https true
     * **/

so after you called Annotation::parseAnnotation method with StandardAnnotationParser ,you will get a array,it`s format as follows:, (*8)

$ret=[[
    'name'=>'type',
    'value'=>'post'
    ],[
       'name'=>'https',
       'value'=>'true'
    ]
];

you can do whatever you want with $ret,if you are interested in it,you can read the composer package called thinkphp5-route-helper, (*9)

Contact

I am a php developer in ShenZhen of China,if you also like open source ,you can contact me ,My QQ is 1174332406, (*10)

last but not least,have a nice day!!, (*11)

The Versions

11/03 2018

dev-master

9999999-dev

this library parse php annotation

  Sources   Download

MIT

The Requires

 

by Avatar saberyjs

11/03 2018

1.2.1

1.2.1.0

this library parse php annotation

  Sources   Download

MIT

The Requires

 

by Avatar saberyjs

06/03 2018

1.0

1.0.0.0

this library parse php annotation

  Sources   Download

MIT

The Requires

  • php >=5.6

 

The Development Requires

by Avatar saberyjs

06/03 2018

1.2

1.2.0.0

this library parse php annotation

  Sources   Download

MIT

The Requires

  • php >=5.6

 

The Development Requires

by Avatar saberyjs