There are a couple of different options to install the Pop PHP Framework. You can use Composer or you can download the stand-alone version from the website

Using Composer

If you want to use the full framework and all of its components, you can install the popphp/popphp-framework repository in the following ways:

Create a new project

composer create-project popphp/popphp-framework project-folder

Add it to the composer.json file

"require": {
    "popphp/popphp-framework": "3.5.*"

Add it to an existing project

composer require popphp/popphp-framework

If you only want to use the core components, you can use the popphp/popphp repository instead of the full popphp/popphp-framework repository.

Stand-alone Installation

If you do not wish to use Composer and want to install a stand-alone version of Pop, you can download a full version of the framework from the website It is set up for web applications by default, but can be used to handle CLI applications as well. The following files and folders are included:

  • /public/
    • index.php
    • .htaccess
  • /vendor/

The /vendor/ folder contains the autoloader, the framework and all of the necessary components.


The only main requirement for the Pop PHP Framework is that you have at least PHP 5.6.0 installed in your environment. It has been tested and works with PHP 7.0 as well.


Web Server

When writing web applications, a web server that supports URL rewrites is recommended, such as:

  • Apache
  • Nginx
  • Lighttpd
  • IIS


Various components of the Pop PHP Framework require different PHP extensions to function correctly. If you wish to take advantage of the many components of Pop PHP, the following extensions are recommended:

  • pop-db
    • mysqli
    • pdo_mysql
    • pdo_pgsql
    • pdo_sqlite
    • pgsql
    • sqlite3
    • sqlsrv
  • pop-image
    • gd
    • imagick*
    • gmagick*
  • pop-cache
    • apc**
    • memcache**
    • memcached**
    • redis
    • sqlite3 or pdo_sqlite
  • other
    • curl
    • ftp
    • ldap

* - The imagick and gmagick extensions cannot be used simultaneously.

** - No stable support for this extension in PHP 7 as of July 2, 2016