What is PHIVE and how it can help us with phar file installation?
Adding all the required tools like PHPUnit, PHPMD and phpDox in their matching versions to a project used to be a lot of repetitive work: Started by finding the download URL, figuring out what the actually correct and matching version is followed by verifying the SHA1 and GPG signatures and making the archive executable. And of course you’d have to repeat this very thing for every tool needed.
Why not just use composer to install phar?
You could have used composer to manage your phar tools installation. Only to clutter your project’s dependencies with the ones of your tools. And fight their potential dependency conflicts. But this is not ideal and should not be necessary for you tu use phar files.
Best way to install phar files
Use PHIVE to install and manage your project’s tooling needs without all the hassle and without cluttered dependencies!
PHIVE supported tools (
Many famous PHP tools can already be installed via PhiVE. Among them the following well known projects:
…. and many more!
To install PHIVE on windows you need to download a phar file and place it in a directory linked in your Windows environment folder. Such as C:/bin. If a directory does not exist, create it and add it to your windows path.
Now make phar file executable so you dont have to type
phive.phar and you can use it only as
phive from your CMD (see next section).
How to run .phar file without typing extension from CMD in Windows 10 PowerShell
Assuming that you have placed your phive.phar file in a directory listed in your Windows env. Create
phive.cmd a file with in the same directory and add the fallowing content:
@php "%~dp0phive.phar" %*
- note that there is a space on the end of the line!
Alternatively, you could try to create phive.bat in the same directory (In my case, that will be C:/bin). Add space on the end of the line.
@ECHO OFF php "c:/bin/phive.phar" %*
phive.phar cmd run as alias
phive in bash terminal.
If you use gitbash or cmder with gitbash selected, you will need to create alias for
phive.phar command. In git bash alias can be written to
Add the fallowing line
alias phive='phive.phar' to the file like in the example below:
alias phive='phive.phar' alias wp='wp-cli.phar' alias phpunit='phpunit.phar'
Install phar tools using PHIVE
phive install phpunit phive install phpDocumentor
If your CURL has certificate issue: fix it fallowing this tutorial php-curl-issue-with-certificate-solved.
Because PHIVE auto generate .bat files which will work in PowerShell without extension but will not trigger in git bash, we need to alias .bat file like .phar files, presented in previous section. So we need to add to
alias phive='phive.phar' alias wp='wp-cli.phar' alias phpunit='phpunit.bat' alias phpDoc='phpDocumentor.bat'
Remember to restart your terminal, so it can load the above modification. We can also try to load modification by running:
If for some reason this will not work, you can always try to define a full path to a .bat file, like this: