Download the PHP package belgattitude/pjbserver-tools without Composer

pjbserver-tools

The pjbserver-tools package currently provides an easy installable php java bridge standalone server. See the soluble/japha and php-java-bridge projects to get more info about php/java integration.

Note that the pjbserver-tools standalone server utility was made for easy composer installation when developing or testing.

For production, building a customized PHPJavaBridge server is really easy. Check the recommended php/java/bridge installation notes

Use cases

The java bridge standalone server can be used as an alternative to a regular bridge installation for php/java integration while keeping things simple for development, unit testing or small projects.

Features

• Easy setup of a PHP Java bridge standalone server (*nix).
• Console commands to control the server (start/stop/restart/status).
• API library to customize the behaviour.
• Includes compiled JavaBridge.jar 7.1.3 file.

Requirements

• PHP 5.5+, 7.0 or HHVM >= 3.2.
• Linux/Unix (Mac OSX 10.1+ reported working).
• Java 1.7+ (see install instructions).

Installation

WARNING The phpjavabridge server is not supposed to be run on a public facing server and its use should be limited to interactions on the same host/network with the php client. Do not run it as root neither as it exposes the JVM methods through the network that could be remotely exploited. Do not start it as root neither.

Depending on your needs you can use the pjserver-tools in two ways.

1. Option 1: Composer install

   You can easily add the pjbserver-tools to your existing composer project.

   It can also be added to your development dependencies (replace require by require --dev in the previous command). Very helpful if you intend to test with Travis...

   Test a command line.

2. Option 2: Console, clone the repo.

   First create a path on your filesystem that will hold the server install.

   Clone the repository and use run composer update.

   Test a command line

Usage

Command line

Command line depends on your install method (composer or clone/download).

• With composer the location of the binary is ./vendor/bin/pjbserver-tools and the default config is located in ./vendor/belgattitude/pjbserver-tools/config/pjbserver.config.php.dist.

• With the clone method, binary is ./bin/pjbserver-tools and default config is ./config/pjbserver.config.php.dist.

For clarity, the documentation of console commands is based on the clone method. Simply replace your path whenever needed.

You can use the commands pjbserver:start, pjbserver:stop, pjbserver:restart, pjbserver:status followed by the pjbserver.config.php file to control or query the server status.

If you use the ./config/pjbserver.config.php.dist config file, the server will start on port 8089.

Feel free to create a local copy of this file and adapt for your usage :

Note that the -v, -vv, -vvv option in the command line allows to define the verbosity level of the scripts.

Controlling via the API

Command line is good, but API gives a little more control especially good when setting unit tests and CI.

Here's a little example:

You can also inject any PSR-3 compatible logger to the StandaloneServer.

Configuration

The dist config file ./config/pjbserver.config.php.dist contains the default parameters used in console mode.

Parameters

Some considerations:

• When choosing a port, ensure it's not available publicly (security).
• The default config set log_file and pid_file in the ./var directory, please change the default location to your data directory.
• Avoid storing log_file and pid_file in the global temp directory '/tmp' as it might be cleared by the OS at anytime.

Classpath configuration

Whenever you need to add some java libraries, simply edit the configuration file and look for the classpaths option and add the required jar files.

As an example:

Don't forget to restart the standalone server to reflect the changes.

Using wildcard /my/path/*.jar is possible but should be used with care. All matching files will be appended to classpath by passing arguments in a shell exec. Limits exists...

Debugging

Some useful commands to watch, debug and eventually kill java standalone server process

Getting the status (running/not running)

Reveal the issued command

For example, the issued command the default config can be

Process management

If for any reason the server cannot be stopped through the console, you can lookup the process through the command line.

You can kill the process:

FAQ

How to start automatically at boot

Check for "supervisord" on google, you'll find some recipes but the preferred method is to deploy on Tomcat, see:

• pjb-starter-springboot to build you own production, self-container or deployable servlet or
• php-java-bridge project.

For alternatives to pjbserver-tools standalone.

Coding standards

• PSR 4 Autoloader
• PSR 3 Logger interface
• PSR 2 Coding Style Guide
• PSR 1 Coding Standards