Setting up Wordpress with Composer, Nginx, PHP-fpm on Mac OS X (Development)¶

Settings¶

Mac OS X (10.11.6 & Mac OS Sierra)
MacPorts (2.4.1)
Software
- php71
- mysql57
- Wordpress

Resources¶

nginx documentation - wordpress
Composer in Wordpress
Intro to Wordpress and Composer
John P. Bloch
Wordpress package repo
- wpackagist - Use with composer to install wordpress plugins and themes.

Install Wordpress with composer¶

Install composer - Composer Docs
- Install in /usr/local/bin

Create composer.json file - Make sure composer has latest version or requirements.

{
  "name": "johnpbloch/wordpress",
  "description": "WordPress is web software you can use to create a beautiful website or blog.",
  "keywords": [
    "wordpress",
    "blog",
    "cms"
  ],
  "type": "package",
  "homepage": "http://wordpress.org/",
  "license": "GPL-2.0+",
  "authors": [
    {
      "name": "WordPress Community",
      "homepage": "http://wordpress.org/about/"
    }
  ],
  "support": {
    "issues": "http://core.trac.wordpress.org/",
    "forum": "http://wordpress.org/support/",
    "wiki": "http://codex.wordpress.org/",
    "irc": "irc://irc.freenode.net/wordpress",
    "source": "http://core.trac.wordpress.org/browser"
  },
  "extra": {
    "wordpress-install-dir": "public",
    "installer-paths": {
      "public/wp-content/plugins/{$name}": [
        "type:wordpress-plugin"
      ],
      "public/wp-content/themes/{$name}": [
        "type:wordpress-theme"
      ]
    }
  },
  "require": {
    "php": ">=5.3.2",
    "johnpbloch/wordpress-core-installer": "~0.2",
    "johnpbloch/wordpress-core": ">=4.7"
  },
  "require-dev":{
    "wpackagist-plugin/theme-check": ">=20160523",
    "wpackagist-plugin/wordpress-reset": ">=1.4",
    "wpackagist-plugin/log-deprecated-notices": ">=0.4",
    "wpackagist-plugin/debug-bar":">=0.9",
    "wpackagist-plugin/wordpress-importer": ">=0.6.3"
  },
  "repositories": [
    {
      "type": "composer",
      "url": "https://wpackagist.org"
    },
    {
      "type": "vcs",
      "url": "https://github.com/catenare/aad-sso-wordpress"
    }
  ]
}

Add any additional repositories for plugins or themes being worked on and being hosted in version control

Add the packages under require in composer.json

"require": {
     "catenare/aad-sso-wordpress": "dev-alicart",
      "catenare/custom-theme": "dev-current"
}
"repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/catenare/aad-sso-wordpress"
    },
    {
      "type": "vcs",
      "url": "https://github.com/catenare/custom-theme"
    }
  ]

Run composer install if no composer.lock file present.

Configure DNS¶

Edit /etc/hosts as sudo - Create a local domain name for your site 127.0.0.1 wpsite.demo

Setup ports¶

sudo port install mysql57-server nginx php71-fpm php71. Assumes php71 already installed.

Ports configuration¶

Setup mysql server
- sudo rm -fr /opt/local/var/db/mysql57 - remove current mysql57 db folder if it exists.
- sudo /opt/local/lib/mysql57/bin/mysqld --initialize --user=_mysql - setup new database and default password
- mysql -u root -p - use password generated with previous step
  - ALTER USER 'root'@'localhost' IDENTIFIED BY 'new pass';
Setup php
- cp /opt/local/etc/php.ini-development /opt/local/etc/php.ini
- Configure socket connection for mysql in php.ini
  - Edit [Pdo_mysql] section
    - pdo_mysql.default_socket=/opt/local/var/run/mysql57/mysqld.sock
  - Add cgi.fix_pathinfo = 0; to end of file
Configure fpm - /opt/local/etc/php71 folder
- cp php-fpm.conf.default php-fpm.conf
- cp php-fpm.d/www.conf.default php-fpm.d/www.conf
- Edit php-fpm.d/www.conf to change to socket
```
      ;listen = 127.0.0.1:9000
      listen = "/opt/local/var/run/php71/php71-fpm.socket"
```

Setup nginx - /opt/local/etc/nginx - location of setup file

    server {
            listen       80;
            server_name  localhost;
            root    /path/to/wordpress/public;
            index   index.php;
            location = /favicon.ico {
                log_not_found off;
                access_log off;
            }
            location = /robots.txt {
                allow all;
                log_not_found off;
                access_log off;
            }


             location / {
                try_files $uri $uri/ /index.php?args;
             }

            location ~ \.php$ {
                fastcgi_param   HTTP_PROXY "";
                fastcgi_pass    unix:/opt/local/var/run/php71/php71-fpm.socket;
                include        fastcgi.conf;
                fastcgi_intercept_errors on;
            }

            location ~* \.(js|css|png|jpg|jpeg|gif|ico)$ {
                expires max;
                log_not_found off;
            }


            # deny access to .htaccess files, if Apache's document root
            # concurs with nginx's one
            #
            #location ~ /\.ht {
            #    deny  all;
            #}
        }

Restart nginx
- sudo port unload nginx
- sudo port load nginx
Restart fpm
- sudo port unload php71-fpm
- sudo port load php71-fpm
Restart Mysql server
- sudo port unload mysql57-server
- sudo port load mysql57-server
Install Wordpress-cli - wordpress command line admin - using composer - Wordpress CLI composer global require wp-cli/wp-cli - will have to include composer bin file in path

Wordpress Development¶

make.wordpress.org
Gutenberg - next level editor

Other options¶

Using sqlite as the database
- Use sqlite plugin for sqlite - SQLite Integration
- Use for lightweight development.

Notes about using Composer to manage a package¶

Notes for managing a custom packages with php composer.¶

Loading a package from a vcs repository

Package must have it’s own composer.json file.

{
  "name": "catenare/smartsheet",
  "description": "API Connection to Smartsheet. Add sheets and add rows",
  "license": "proprietary",
  "authors": [
    {
      "name": "Johan Martin",
      "homepage": "http://www.johan-martin.com",
      "email": "martin.johan@johan-martin.com",
      "role": "developer"
    }
  ],
  "require": {
    "guzzlehttp/guzzle": "^6.2",
    "symfony/console": "^3.3",
    "symfony/dotenv": "^3.3",
    "symfony/dependency-injection": "^3.3",
    "symfony/yaml": "^3.3",
    "symfony/config": "^3.3",
    "symfony/serializer": "^3.3",
    "zendframework/zend-json": "^3.0"
  },
  "minimum-stability": "dev",
  "autoload": {
    "psr-4": { "SmartSheet\\": "src/" },
    "files":["boot.php","main.php"]
  },
  "autoload-dev": {
    "psr-4": { "SheetTest\\": "test/" }
  },
  "require-dev": {
    "phpunit/phpunit": "^6.2"
  }
}

Use dev-{branch} to have composer checkout the correct git branch.

Example:

"require": {
        "catenare/smartsheet": "dev-master"
    },
    "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/catenare/smartsheet-api"
    }
  ]

Other Notes

For wordpress: Use the type property set to wordpress-plugin. Wordpress installer will install it in the right location. Composer seems to be reluctant to go more than one level deep when checking out dev branches.

{
    "name": "catenare/ninjaforms-smartsheet-plugin",
    "description": "Add form data to smartsheet",
    "type": "wordpress-plugin",
    "license": "proprietary",
    "authors": [
    {
        "name": "Johan Martin",
        "homepage": "http://www.johan-martin.com",
        "email": "martin.johan@johan-martin.com",
        "role": "developer"
    }
    ],
    "keywords":[
        "alicart",
        "ninja-forms",
        "smartsheet"
    ],
    "require": {
        "catenare/smartsheet": "dev-master"
    },
    "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/catenare/smartsheet-api"
    }
  ]
}

Dependencies for sub packages in vcs. Put repo info in man composer.json file.

{
  "name": "catenare/wordpress-intranet",
  "description": "Intranet based on WordPress",
  "license": "proprietary",
  "keywords": [
    "intranet",
    "secure"
  ],
  "type": "package",
  "homepage": "http://www.johan-martin.com",
  "authors": [
    {
      "name": "WordPress Community",
      "homepage": "http://wordpress.org/about/"
    },
    {
      "name": "Johan Martin",
      "homepage": "http://www.johan-martin.com",
      "email": "martin.johan@johan-martin.com",
      "role": "developer"
    }
  ],
  "support": {
    "email": "martin.johan@johan-martin.com"
  },
  "extra": {
    "wordpress-install-dir": "public",
    "installer-paths": {
      "public/wp-content/plugins/{$name}": [
        "type:wordpress-plugin"
      ],
      "public/wp-content/themes/{$name}": [
        "type:wordpress-theme"
      ]
    }
  },
  "require": {
    "php": "~7",
    "johnpbloch/wordpress-core-installer": "~0.2",
    "johnpbloch/wordpress-core": "~4.7",
    "wpackagist-plugin/login-lockdown":"~1.7",
    "wpackagist-plugin/all-in-one-intranet": "~1.2",
    "wpackagist-plugin/ninja-forms":"~3.1",
    "catenare/aad-sso-wordpress": "dev-alicart",
    "catenare/ninjaforms-smartsheet-plugin": "dev-master"
  },
  "require-dev": {
    "phpunit/phpunit": "^6.2"
  },
  "repositories": [
    {
      "type": "composer",
      "url": "https://wpackagist.org"
    },
    {
      "type": "vcs",
      "url": "https://github.com/catenare/aad-sso-wordpress"
    },
    {
      "type": "vcs",
      "url": "https://github.com/catenare/ninjaforms-smartsheet"
    },
    {
      "type": "vcs",
      "url": "https://github.com/catenare/smartsheet-api"
    }
  ]
}

Added smartsheet-api vcs because ninjaform-smartsheet-plugin dependent on it.

Last update: April 13, 2020 15:50:46