Using Composer with WordPress | Nexcess

Using Composer with WordPress | Nexcess

WordPress has been round since 2003 and has develop into the default instrument for most individuals seeking to begin an internet site. While it’s come a great distance from its roots as a weblog engine, the underlying know-how hasn’t made the identical leaps that the consumer expertise has.

WordPress growth nonetheless revolves round lots of the requirements that have been current in 2003. While this may make it extra accessible to individuals because of the decrease technical understanding required, it additionally implies that many new growth sources are usually not suitable with WordPress out of the field.

Today, we’re going to check out a type of newer instruments referred to as Composer. Let’s see the way it can match into your WordPress workflow and talk about why it’s possible you’ll need to attempt it out.

What is Composer?

Every little bit of code you write has dependencies. If you’re writing a WordPress plugin your greatest dependency is WordPress itself. Without the core features that WordPress offers, it’s possible that your plugin isn’t helpful in any respect. Outside of WordPress itself, you might want a contemporary SOAP shopper like nusoap to interface with SOAP-based APIs.

In the previous, most individuals would merely copy the repository for nusoap right into a listing of their plugin after which embody the recordsdata wanted to make use of the library. This is the place Composer can step in and simplify among the administration of your dependencies.

Composer is a dependency supervisor. It’s particularly designed to make it simple to put in and handle dependencies. This can develop into particularly essential should you’re working in a staff and need to guarantee that each member of the staff is utilizing the identical libraries as they do their growth work.

At its base, Composer is a JSON file that particulars the dependencies you’ve got put in and which variations of the dependencies you need to use. You can see a fundamental instance beneath that features the nusoap dependency.


    “require”: {

        “econea/nusoap”: “^0.9.10”



When I run composer require econea/nusoap in my plugin it should set up nusoap for me and lock it to the model specified. In this case, I’m utilizing 0.9.10 and can proceed to make use of that until I inform Composer to improve the dependency.

This has the benefit over merely downloading and together with nusoap as a result of I can use composer replace to replace all my dependencies while not having to go see if there are updates and manually obtain them into my undertaking. Composer takes over the administration of sources at this stage.

Getting Started with Composer

Installing composer is pretty simple.

On Windows

If you’re on Windows then there’s an installer provided to simplify the method. It will set up the newest model of Composer and make it accessible globally on your tasks.


On any of those platforms, you’ve got a number of extra steps to get Composer setup. To begin, run the instructions wanted to obtain Composer and get it setup.

php -r “copy(‘’, ‘composer-setup.php’);”

php -r “if (hash_file(‘sha384’, ‘composer-setup.php’) === ‘756890a4488ce9024fc62c56153228907f1545c228516cbf63f885e036d37e9a59d27d63f46af1d4d07ee0f76181c7d3’) { echo ‘Installer verified’; } else { echo ‘Installer corrupt’; unlink(‘composer-setup.php’); } echo PHP_EOL;”

php composer-setup.php

php -r “unlink(‘composer-setup.php’);”

Next, you’ll need to run Composer globally for native growth so we’ll want to regulate the default set up to make sure that it’s accessible any time we need to use Composer. You can transfer Composer to be globally accessible with the next command executed from the identical listing you simply downloaded Composer from.

mv composer.phar /usr/native/bin/composer

Upgrading Composer

On Windows and macOS all you have to do to improve to the newest model of Composer is run composer self-update. If you’re on Linux/Unix then you definately’ll have to run sudo apt replace && improve in order that your system checks for the newest variations then you’ll be able to run composer self-update to get the newest model.

Now that you simply’re arrange, let’s check out utilizing Composer to put in WordPress.

Install WordPress with Composer

What about if you wish to handle a whole web site with Composer? First, you have to resolve if WordPress is the dependency of the undertaking or the core of the undertaking? Yup, a bit of brain-twisting.

WordPress might be thought of a dependency of the undertaking as a result of the tip purpose on your clients isn’t to have WordPress put in. They desire a retailer or a weblog and that depends upon you putting in WordPress. This is the stance {that a} undertaking like Roots takes with its Composer primarily based Bedrock WordPress setup referred to as Bedrock.

Using Bedrock implies that you don’t have to inform Composer about WPackagist as a result of it’s already arrange. It’s the place I like to recommend you begin should you’re seeking to handle a whole web site with Composer.

To set up Bedrock run the next command.

composer create-project roots/bedrock

This offers you the next file construction.

├── composer.json

├── .env

├── config

│   ├── software.php

│   └── environments

│       ├── growth.php

│       ├── staging.php

│       └── manufacturing.php

├── vendor

└── net

    ├── app

    │   ├── mu-plugins

    │   ├── plugins

    │   ├── themes

    │   └── uploads

    ├── wp-config.php

    ├── index.php

    └── wp

This could be very totally different than the usual WordPress setup. To begin you’ve got your composer.json file on the root of the set up. This is the place you’ll see your Composer configuration. 

Your .env file is the place you’ll be able to retailer the totally different database configurations. This is required as a result of your native web site and your stay web site can have totally different database passwords and usernames. The default wp-config.php file will perceive the variables you set in your .env file as a result of Bedrock makes use of these variables as an alternative of laborious coding within the database connection info.

You’re .env file must be ignored in your Git repository. When you configure a brand new web site you add a brand new .envfile to it with the required database configuration info.

There are a number of different variables that you have to arrange right here to get Bedrock began, that are all detailed of their documentation.

Under the config folder areis totally different default configurations for the environments you’ll be utilizing. In growth, this activates error reporting, and in your manufacturing environments, it makes positive that error logging received’t intrude with the sleek operation of your web site.

With Bedrock as a base, now you can use Composer to put in your WordPress plugins through WPackagist.

WPackagist is a mirror of the WordPress theme and plugin repository. This is required as a result of by default most plugins and themes are usually not accessible for Composer to put in. The mirror provides the required recordsdata for every plugin in order that Composer can be utilized to handle the plugins.

If you wished to put in WooCommerce in your Bedrock primarily based WordPress set up you have to require WooCommerce first, composer require wpackagist-plugin/woocommerce, then you have to inform Composer to put in the dependencies, composer set up.

Now you’ll be able to go to the admin space of your WordPress set up and activate WooCommerce and get constructing out your web site. To replace WooCommerce when a brand new model comes out, or to replace WordPress, you have to run composer replace.

This is the place a Composer primarily based undertaking can get right into a little bit of bother. If you run your updates by the WordPress admin then you definately’ll have a mismatch between what Composer expects and what WordPress has put in. If you’re going to go with Composer, then stick with utilizing it as your updating instrument and don’t work through the WordPress admin.

When Should You Use Composer?

I’m positive that a lot of you might be asking why Composer is such an ideal instrument for WordPress growth. WordPress wasn’t constructed with Composer in thoughts, so to work with it it’s a must to soar by some hoops to make it work properly.

For plugin and theme builders there’s a clear case that Composer could make it simpler to deal with dependencies you have to herald from the broader PHP ecosystem. For WordPress builders, the argument is much less clear. Some like to make use of Composer to handle their complete web site as Roots does. This can let you’ve got fewer recordsdata managed by Git, however that has by no means appeared like a compelling case to me. 

The case I like is that Composer could make it simple to have totally different dependencies for various environments. You can then use your deployment course of to deploy these dependencies in your environments and never should manually handle them.

As a developer, you additionally have to take your shopper’s wants under consideration. If they don’t have a growth staff round to handle the location long run, then they could run into points with a non-standard WordPress set up. In some instances, their hosts might inform them that assist isn’t accessible as a result of they’re not utilizing the traditional approach of putting in and utilizing WordPress. When you serve shoppers you all the time have to stability the cool know-how you utilize with what the shopper can deal with long run.

For this cause alone, I don’t use Composer in my full web site tasks. My shoppers are going to be managing them daily for years and I don’t need to put up any further boundaries. We each need their websites to run easily for years to return.

If you’re seeking to improve your PHP expertise with fashionable applied sciences, then it’s best to actually check out how Composer can match into your WordPress workflows.

Check Also

How Ethical Brands Can Leverage DoneGood for Better Visibility

How Ethical Brands Can Leverage DoneGood for Better Visibility

For a very long time, consumerism has earned a status as being the bane of …