Download the PHP package voku/php-readme-helper without Composer
On this page you can find all versions of the php package voku/php-readme-helper. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download voku/php-readme-helper
More information about voku/php-readme-helper
Files in voku/php-readme-helper
Package php-readme-helper
Short Description auto-generate your README from your code
License MIT
Homepage https://github.com/voku/Php-Readme-Helper
Informations about the package php-readme-helper
📖 PHP README Helper
Helper to auto-generate the API documentation in your README file.
Example
(build/generate_docs.php)
Template placeholders
In your base markdown file, use the following placeholders:
| Placeholder | Description |
|---|---|
%__functions_index__ClassName__% |
Renders an HTML table index of all public methods. |
%__functions_list__ClassName__% |
Renders the full API documentation for all public methods. |
%__properties_index__ClassName__% |
Renders an HTML table index of all public properties (optional). |
%__properties_list__ClassName__% |
Renders the full documentation for all public properties (optional). |
%__enum_cases__ClassName__% |
Renders all cases of a PHP enum (optional). |
Replace ClassName with the fully-qualified class name using backslashes, e.g. voku\PhpReadmeHelper\GenerateApi.
GenerateApi
generate(string $codePath, string $baseDocFilePath, string[]|null $useClasses): string
↑ This method can generate API documentation with types from php code into your README file.
Parameters:
string $codePath <p>Path to a file or a directory.</p>string $baseDocFilePath <p>Path to your base file for the README.</p>string[]|null $useClasses <p>If used, you can specify to classes, you will use.</p>
Return:
string <p>Return a string with the generated README.</p>
Support
For support and donations please visit Github | Issues | PayPal | Patreon.
For status updates and release announcements please visit Releases | Twitter | Patreon.
For professional support please contact me.
Thanks
- Thanks to GitHub (Microsoft) for hosting the code and a good infrastructure including Issues-Managment, etc.
- Thanks to IntelliJ as they make the best IDEs for PHP and they gave me an open source license for PhpStorm!
- Thanks to Travis CI for being the most awesome, easiest continous integration tool out there!
- Thanks to StyleCI for the simple but powerfull code style check.
- Thanks to PHPStan && Psalm for really great Static analysis tools and for discover bugs in the code!