JPHP Package Manager

JPPM is a packager manager for jphp like npm (js) or composer (php). JPPM will help you to build and run jphp applications.

IMPORTANT: JPPM and JPHP requires Java 8 or 9+. Download here: https://java.com/download/.

For Windows Users

• Download the installer (*.exe) of the last jppm version here: https://github.com/jphp-compiler/jphp/releases
• Run the downloaded installer (jppm-setup-{version}.exe).

For Linux Users

• Use the linux install instructions from the last jppm version here: https://github.com/jphp-compiler/jphp/releases

That's all! Try to check jppm in console.

jppm version 

• Clone the jphp repository from https://github.com/jphp-compiler/jphp.git.
• Open repo directory in your console and run:

On Linux (it will create link of jppm to /usr/bin/jppm, use sudo if needed):

sudo ./gradlew packager:install --no-daemon 

On Windows:

gradlew packager:install --no-daemon 

• [Only if Windows] Add the jppm bin path to your system properties, use %UserProfile%\.jppm\dist for bin path.

• Restart your console!

After all of this the jppm command will available in your console. Try to get version of jppm:

jppm version 

It should print a version information about jphp.

Run and select options:

jppm init 

• If you choose add AppPlugin (yes) so you can run the created package as jphp application, use start:

jppm start 

It will println Hello World in your console. The php source of the package see in src/index.php.

If you didn't choose the add AppPlugin option as no, use this manual.

• Before, add AppPlugin to your package.php.yml (see plugins sections), e.g.:

name: test plugins: - AppPlugin # include app plugin # ... 

• Now, the command start, build, clean will be availble.
• Add jphp compiler dependency to your package.php.yml:

name: test plugins: - AppPlugin # include app plugin deps: jphp-core: '*' jphp-zend-ext: '*' jphp-httpserver-ext: '*' # add http server extension 

• Add a bootstrap script to your app, e.g src/index.php:

<?php echo "Hello World";

• Add the path of the bootstrap script in package.php.yml:

name: test plugins: - AppPlugin # include app plugin deps: jphp-core: '*' jphp-zend-ext: '*' jphp-httpserver-ext: '*' # add http server extension  sources: - 'src' # add 'src' dir as source directory (for class loader too). includes: - 'index.php' # include php files at start up from sources directories.

• Now, you can run jppm start to run you app.
• And you can run jppm build to build your app with launch scripts for windows and linux!