library php-docbloc

intrd/php-docbloc

PHP docBloc - Generate and keep updated docBlock of your project files fetching details from composer.json and Git. Supported filetypes: *.php, *.ini, *.sh, *.bat, *.md (No Composer or PEAR need to be installed to use this tool).

docBloc - Generate and keep updated docBlock of your project files fetching details from composer.json and Git data. Supported filetypes: *.php, *.ini, *.sh, *.bat, *.md (No Composer or PEAR needed to use this tool)., _(*1)

, _(*2)

, _(*3)

Composer.json sample

docBloc fetch your project details from composer.json. If your project still does not have one, create it following sample below and put at your project root path., _(*4)

{
    "name": "intrd/docbloc",
    "description": "PHP docBloc - Generate and keep updated docBlock of your project files fetching details from composer.json and Git. Supported filetypes: *.php, *.ini, *.sh, *.bat, *.md (No Composer or PEAR need to be installed to use this tool).",
    "keywords": ["php","docblock","documentation","tool"],
    "homepage": "http://github.com/intrd/docbloc",
    "authors": [
            {
                "name": "intrd (Danilo Salles)",
                "email": "x@dann.com.br",
                "homepage": "http://dann.com.br",
                "role": "Developer"
            }
        ],
    "license": "CC-BY-SA-4.0",
    "require": {
        "php": ">=5.3.0"
    },
    "autoload": {
        "psr-4": {
            "php\\":"src/"
        }
    },
    "extra": {
        "author_twitter":"intrd",
        "copyright_author":"intrd",
        "license_title":"Creative Commons Attribution-ShareAlike 4.0",
        "license_url":"http://creativecommons.org/licenses/by-sa/4.0"
    }
}

Docbloc triggers

Each filetype have your own trigger, put this in the header of files that you want to docBloc manage., _(*5)

PHP - Script, _(*6)

/** @docbloc **/

INI - Configuration file, _(*7)

;; @docbloc ;;

SH - Shell script, _(*8)

## @docbloc ##

BAT - Batch script, _(*9)

REM @docbloc REM

MD - Markdown files like README.md, _(*10)

<!-- @docbloc -->

Git details

(optional) I recommend you to control the versioning of your project by Git branch name. It's optional, but docbloc fetch version from .git/HEAD. If your project are not gitted, docbloc will not display the Version field at files., _(*11)

Usage

Considering that you already have: - PHP working - Created/edited your composer.json - Filled all files w/ the correct docBloc trigger - (optional) a working .git/HEAD, _(*12)

Now go to your project root and run:, _(*13)

$ wget -O docbloc.php https://raw.githubusercontent.com/intrd/docbloc/1.1/src/docbloc.php && php docbloc.php && rm docbloc.php

, _(*14)

It will download docbloc.php script, run and remove it., _(*15)

Done, Every time you change any project detail at composer.json or create a new git branch version, simply run docBloc again to keep all your files docbloc header updated. Yes, it works recursively on upper directory levels too., _(*16)