Skip to content

alash3al/phoo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

50 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PHOO

modern php application server, it depends on the bullet-proof php-fpm but it controls how it is being run.

Examples

Imagine you have a php application that uses a modern framework like laravel, Symfony... etc that app contains a public directory, and that public directory contains the main bootstrap file that serves the incoming requests named index.php.

# this is all that you need to serve a laravel application!
$ phoo serve -r ./public
⇨ http server started on [::]:8000

But how about changing the address it is listening on to 0.0.0.0:80?

# no problem
$ phoo serve -r ./public --http 0.0.0.0:80
⇨ http server started on [::]:80

Sometimes I want to add custom php.ini settings, is it easy?

# is this ok for you? ;)
$ phoo serve -r ./public -i display_errors=Off -i another_key=another_value
⇨ http server started on [::]:8000

I have a high traffic web app and I want to increase the number of php workers

# increase the workers' count
$ phoo serve -r ./public --workers=20
⇨ http server started on [::]:8000

Hmmmm, but I want to monitor my app via Prometheus metrics, I don't want to do it manually

# no need to do it yourself, this will enable Prometheus metrics at the specified `/metrics` path
$ phoo serve -r ./public --metrics "/metrics"
⇨ http server started on [::]:8000

Can I choose the php-fpm version / binary path?

# Of course
$ phoo serve -r ./public --fpm "php-fpm8.2"
⇨ http server started on [::]:8000

Wow!, it seems phoo has a lot of simple flags/configs, is it documented anywhere?

Just run phoo serve --help and enjoy it :), you will find that you can also pass flags via ENV vars, and it will automatically read the .env file in the current working directory.

Requirements

  • php-fpm
  • a shell access to run phoo :D

Installation

  • Binary installations could be done via the releases.
  • Docker image is available at ghcr.io/alash3al/phoo
    • you can easily COPY --from=ghcr.io/alash3al/phoo:2.1.8 /usr/bin/phoo /usr/bin/phoo to run it into your own custom image!

TODOs

  • Add .env.example with comments to describe each var.
  • Add future plans/thoughts.