awsnginx

Get started with Laminas

The Laminas Project was previously known as Zend Framework, and is not included by default in Bitnami installations. However, it can be easily enabled using Composer. In this guide, you will learn how to install and configure a Laminas project.

Installation and Testing

NOTE: This section assumes that the application project directory will be located at /opt/bitnami/projects/APPNAME. Remember to replace the APPNAME placeholder with the application name, such as myapp.

  • First, create a project directory where to store your application. Run the following commands:

    $ sudo mkdir -p /opt/bitnami/projects/APPNAME
    $ sudo chown $USER /opt/bitnami/projects/APPNAME
    
  • Create the Laminas project. Run the following command:

    $ composer --no-interaction create-project -s dev laminas/laminas-mvc-skeleton /opt/bitnami/projects/APPNAME
    
  • Grant write permissions for the web server to the data directory. Run the following command:

    $ sudo chown daemon:daemon /opt/bitnami/projects/APPNAME/data
    
  • Create the NGINX configuration for your application. Follow these steps:

    • Create the /opt/bitnami/nginx/conf/server_blocks/APPNAME-server-block.conf file containing the application’s HTTP server block configuration with the configuration block shown below:

      server {
          # Port to listen on, can also be set in IP:PORT format
          listen 80 default_server;
          root /opt/bitnami/myapp/public;
          # Catch-all server block
          # See: https://nginx.org/en/docs/http/server_names.html#miscellaneous_names
          server_name _;
          include  "/opt/bitnami/nginx/conf/bitnami/*.conf";
      }
      
    • Create the /opt/bitnami/nginx/conf/server_blocks/APPNAME-https-server-block.conf file containing the application HTTPS server block configuration with the configuration block shown below:

      server {
          # Port to listen on, can also be set in IP:PORT format
          listen 443 ssl default_server;
          root /opt/bitnami/myapp/public;
          # Catch-all server block
          # See: https://nginx.org/en/docs/http/server_names.html#miscellaneous_names
          server_name _;
          ssl_certificate      bitnami/certs/server.crt;
          ssl_certificate_key  bitnami/certs/server.key;
          include  "/opt/bitnami/nginx/conf/bitnami/*.conf";
      }
      
  • Finally, restart the NGINX server:

    $ sudo /opt/bitnami/ctlscript.sh restart nginx
    

You can now verify that the example application is working by visiting its URL using your browser at http://SERVER-IP/. Here is an example of what you might see:

Laminas welcome page

Configuration

If your application will use a database, MySQL support is already available by default. If you plan to use PostgreSQL, enable the pdo_pgsql extension in the /opt/bitnami/php/etc/php.ini file.

extension=pdo_pgsql

More Information

Learn more about developing applications with the Laminas Project at https://docs.laminas.dev/.

Last modification July 29, 2020