loilo/native-open

Open a file/URL/app from inside PHP, cross-platform

Maintainers

Details

github.com/loilo/native-open

Source

Issues

Installs: 228

Dependents: 0

Suggesters: 0

Security: 0

Stars: 2

Watchers: 1

Forks: 0

Open Issues: 0

pkg:composer/loilo/native-open

1.0.0 2019-08-19 08:43 UTC

Requires

Requires (Dev)

MIT d83743bea924c4d6633081c2b7282eb6cbad0a58

  • Florian Reuschel <florian.woop@loilo.de>

This package is auto-updated.

Last update: 2025-10-09 22:27:58 UTC

README

native-open logo: A mouse pointer, presented as a hand with extended index finger, floating above a colored circle representing an interactive area.

Native Open

This package enables you to open a file/URL/app from inside PHP, cross-platform.

Note that it opens the app on the machine running the PHP code, so you can not use it to open apps on behalf of your website's users.

Most of the credit for this package goes to Sindre Sorhus as this is mostly a port of his open package for Node.js.

Installation

composer require loilo/native-open

Usage

use Loilo\NativeOpen\NativeOpen;

// Opens the image in the default image viewer
NativeOpen::open('picture.jpg'); 

// Opens the URL in the default browser
NativeOpen::open('https://github.com/loilo');

// Opens the URL in a specified browser
NativeOpen::open('https://github.com/loilo', 'firefox');

// Specify app arguments
NativeOpen::open('https://github.com/loilo', 'google chrome', ['--incognito']);

This package uses the open command on macOS, start on Windows and xdg-open on other platforms. Note that, if you define a specific app to open a target in, the app name is platform dependent. Don't hard code it in reusable modules. For example, Chrome is google chrome on macOS, google-chrome on Linux and chrome on Windows.