PhD using Composer - proof of concept and a few questions

From: Date: Fri, 09 Dec 2016 17:52:34 +0000
Subject: PhD using Composer - proof of concept and a few questions
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969386437@lists.php.net to get a copy of this message
Hello. I would like to bring a topic to discussion - switching PhD (our docs building script) from PEAR to Composer. I briefly discussed it last year and Hannes (its creator) gave me green light to try it (with making it a monolithic package included). Today, I finally found some time to present you working proof of concept. You can find it at: https://github.com/Sobak/phd/tree/composer (diff of all changes made is available here - https://github.com/php/phd/compare/master...Sobak:composer) ATM it's not hosted on packagist so to install it locally as a Composer package you need to clone it, find (or create) COMPOSER_HOME/config.json and add: {
    "repositories": [
        {
            "type":"vcs",
            "url":"D:\\WWW\\htdocs\\forks\\phd"
        }
    ]
} Then you can $ composer global require php/phd dev-composer It should work exactly like before (try phd --help or phd --version to test it). Manual is building fine on my local machine (I didn't touch rendering/building logic at all). I would love to see that implemented on PHP.net. I think it would make releasing new versions much easier. But first, I need to ask a few questions (I allowed myself to cc systems@ as some of them are related to our infrastructure). 1) Do I understand it correctly that in fact PHP Manual is build only on two boxes? docs.php.net (euk2) and rsync (sc2)? 2) Are there any circumstances that prevent such change? Other than "it always worked", please ;) Composer requires only PHP 5.3.2 and that requirement is met on euk2 box - I don't know about sc2 though. 3) Assuming that we want such change. Under whose account should it be kept on Packagist. There is one named "php" but I don't think it belogs to any of us. Maybe new account like "phpnet" or "phpdotnet". Or maybe Hannes would like to have it assigned, as its main creator? 4) Any other problems I'm not aware of? 5) Any implementation suggestions/concerns? I would happily address them. Just please be aware that it's only a proof of concept at the moment. I'm hoping for a fruitfull discussion. Constructive criticism is always welcome, as well. Cheers! Maciej.

« previous php.doc (#969386437) next »