Jonathan Scheiber

Symfony CLI binary allows to start a local PHP server to run your application. Many interesting options are available: local domain, HTTPS... Let's discover undocumented options or options recently documented!

Workers configuration

We can define workers, that will start automatically with the server (example taken from documentation):

# .symfony.local.yaml
workers:
    # Automatically start "yarn encore" in "watch" mode
    yarn_encore_watch: ~

    # Automatically start "messenger:consume" with "async" transport
    messenger_consume_async: ~

    # You can also define your own commands
    build_spa:
        cmd: ['yarn', '--cwd', './spa/', 'dev']

Local wildcard domain

You probably knew that you can define local domains, for example "project.wip".

But did you know that you can also define local wildcard domains?

symfony proxy:domain:attach "*.myproject"

This way, your projet will handle eg. admin.myproject.wip, custom.myproject.wip...

Configure options using a configuration file

As you read above, the .symfony.local.yaml file allows to configure workers. But, what's not yet documented is that there are other options available!

# Sets domain1.wip and domain2.wip for the current project
proxy:
    domains:
        - domain1
        - domain2

http:
    document_root: public/ # Path to the project document root
    passthru: index.php # Project passthru index
    port: 8000 # Force the port that will be used to run the server
    preferred_port: 8001 # Preferred HTTP port [default: 8000]
    p12: path/to/p12_cert # Name of the file containing the TLS certificate to use in p12 format
    allow_http: true # Prevent auto-redirection from HTTP to HTTPS
    no_tls: true # Use HTTP instead of HTTPS
    daemon: true # Run the server in the background
    use_gzip: true # Toggle GZIP compression

Caution: if you define local domains using this configuration file, when you will run the server:start command, domains defined using the proxy:domain:attach command will be overridden.

 

Et voilà! :) If you have any questions, comments, suggestions... Feel free to post a comment below :)