eloquent/liftoff

Open any file or URI using the default GUI application from within PHP.

Liftoff

Open any file or URI using the default GUI application from within PHP., _(*1)

, _(*2)

Installation and documentation

• Available as Composer package eloquent/liftoff.
• Executable phar available for download.
• API documentation available.

What is Liftoff?

Liftoff provides a simple interface to launch a file or URI in the host operating system's default application, in a cross-platform manner. Liftoff can be used, for example, to launch a HTML page in the operating system's default browser from within a command line PHP application., _(*3)

Usage

Liftoff can be used as a library, to launch files and URIs from within a PHP application:, _(*4)

use Eloquent\Liftoff\Launcher;

$launcher = new Launcher;

$launcher->launch('/path/to/file.html');
$launcher->launch('/path/to/file.html', array('--with', '--arguments'));

$launcher->launch('http://example.org/');
$launcher->launch('http://example.org/', array('--with', '--arguments'));

Arguments provided as the second parameter will be forwarded on to the associated application., _(*5)

Command line interface

Liftoff comes with a command line interface which can be used to launch files and URIs from the command line:, _(*6)

liftoff /path/to/file.html
liftoff /path/to/file.html --with --arguments

liftoff http://example.org/
liftoff http://example.org/ --with --arguments

Arguments after the path (or URI) will be forwarded on to the associated application., _(*7)