silverstripe / serve
Connects the PHP development server to SilverStripe
Installs: 353 801
Dependents: 5
Suggesters: 0
Security: 0
Stars: 22
Watchers: 10
Forks: 11
Open Issues: 4
Requires
- php: ^8.1
- silverstripe/framework: ^5
- symfony/process: ^6.1.3
Requires (Dev)
- phpunit/phpunit: ^9.5
- squizlabs/php_codesniffer: ^3.7
README
A simple dev task, to start a development server for your Silverstripe app.
Getting started
$ composer require silverstripe/serve $ framework/sake dev/build flush=1 $ vendor/bin/serve
This will start the server at http://localhost:8080
.
You can override the host/port:
$ vendor/bin/serve --host 127.0.0.1 --port 8000
Opening a browser
You can add the --open
argument to open a new browser window with the new server.
$ vendor/bin/serve --open
Including a bootstrap file
The bootstrap-file argument lets you include a custom PHP file after composer has been loaded (which includes Silverstripe’s Constants.php) but before main.php has been loaded.
This can be used for any number of things, but the primary use-case is to pull in any stub code & config that wouldn’t normally be included by Silverstripe in the current execution session, such as test stubs.
$ vendor/bin/serve --bootstrap-file tests/serve-bootstrap.php
Using as a library
You can also use serve as a library, to start a Silverstripe server from some other tool such as a test suite:
Assuming that BASE_PATH
is defined, you can use it like this:
use SilverStripe\Serve\ServerFactory; $factory = new ServerFactory(); $server = $factory->launchServer([ 'host' => 'localhost', 'preferredPort' => 3000, ]); // Print the contents of the homepage echo file_get_contents($server->getURL()); // Stop the server when you're done with it $server->stop();
If BASE_PATH
is not defined, e.g. if you are not running a SapphireTest,
you can provide an alternative path to the factory constructor:
$factory = new ServerFactory(realpath(__DIR__ . '/../'));
launchServer allows the following options to be passed to it:
- host: The host to listen on, defaulting to 0.0.0.0
- preferredPort: The preferred port. If this port isn't available, the next highest one will be used
- bootstrapFile: The bootstrap file, as described above
Using as global
composer global require silverstripe/serve
Then you can run serve
with the --path
argument
serve --path=.