The Themosis framework has its own way for defining WordPress configurations. It's done on purpose to facilitate collaboration. By default, the Themosis framework comes with a local and a production environments pre-configured.
You'll start by registering your database credentials and application URLs into a .env.{environment} file located in the root directory of your project. Then you'll be able to define your environment configurations by modifying files located in the config directory.
Opening your project in a text editor or IDE should show you a default
.envfile:.env.local. The framework release is now leveraging the DotEnv PHP package.
By default, we recommend a "multiple" environment configuration but in some cases you might want to use the same credentials for local, staging and why not production environments.
In order to do so, rename the default .env.local file to .env and then open up the config/environment.php and set it to return false.
This will tell the Themosis framework to use the .env file in any environment.
The framework will always load the
config/environments/local.phpconfiguration file as well.
Let's start by installing your WordPress application on a local environment.
Follow the same steps for a remote/production environment or any custom ones.
Open the default .env.local file located in the root of your project. Fill in the values with your local database credentials and specify your local virtual host URLs.
DB_NAME = "your_database_name"
DB_USER = "database_username"
DB_PASSWORD = "database_password"
DB_HOST = "localhost"
WP_HOME = "http://my-website.dev"
WP_SITEURL = "http://my-website.dev/cms"WordPress is defined as a dependency and is loaded by the framework inside the
cmsdirectory located in the web root folderhtdocs. Make sure to always define theWP_SITEURLvalue with/cmsappended at the end.The
DB_NAME,DB_USER,DB_PASSWORD,DB_HOST,WP_HOME,WP_SITEURLvariables are all required. You can retrieve those values any time by using the PHP functiongetenv('DB_NAME');.
Once your credentials are registered, we need to identify the local environment.
2 methods are available in order to identify your environment:
hostnameDefault method used by the framework
In order for the framework to identify your local environment, you have to register your machine/computer hostname in the environment.php file located inside the config directory.
*Find hostname on NIX**
Open your Terminal and simply run the following command:
hostnameFind hostname on Windows
Open your Console and run the following command:
ipconfig/allLook at the first displayed line Host Name.
Once you get your hostname, open the environment.php file and replace the value of the local key:
<?php
/*----------------------------------------------------*/
// Define environment type
/*----------------------------------------------------*/
return [
'local' => 'INSERT-HOSTNAME',
'production' => 'INSERT-PRODUCTION-HOSTNAME'
];The hostname value can be the exact machine name, a wildcard or regular expression. For example:
<?php
return [
'local' => '*.domain.com',
'production' => 'xyz\..+\.net'
];The key defined in the
environment.phpfile is used to load the.env.{$environment}file and also the{$environment}.phpfile located in theconfig/environmentsdirectory.
Multiple hostnames
In some scenarios, you'll probably need to define several hostnames per environment. In order to do so, you can pass an array of hostnames to each environment key. Array values can also be multiple wildcard or regular expressions. Here is an example:
<?php
return [
'local' => ['computer1', 'computer2', '*.project.dev'],
'production' => 'remote machine hostname'
];If you have total control of your web server and are able to set environment variable, you can use a closure in order to load the application environment configuration.
Apache:
Normally you put a SetEnv statement inside your <VirtualHost> directive or if you don't have access to this configuration, you can add it inside your .htaccess file if allowed.
Specify a local environment variable for Apache:
SetEnv varName varValueNow inside your environment.php file, in place of an array, you'll replace your code by a Closure like so:
<?php
return function () {
// Check for the environment variable
if ('varValue' === getenv('varName')) {
// Return the environment file slug name: .env.{$slug}
return 'local';
}
// Else if no environment variable found... it might be a production environment...
return 'production';
};In the example above, if the getenv('varName') exists, this will load the the local environment file: .env.local located at the root of your application.
Nginx:
Nginx has a ENV function but this apparently only works in the main context of your web server. In order to specify an environment variable per server context, you will use the fastcgi_param statement.
server {
location ~ \.php$ {
include fastcgi_params;
fastcgi_pass themosis.dev:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name";
###############################
# Your environment variable #
###############################
fastcgi_param varName varValue;
}
}For Nginx, your environment variable is accessible by using $_SERVER[]. So inside your environment.php file, you'll write:
<?php
return function () {
// Check for the environment variable
if ('varValue' === $_SERVER['varName']) {
// Return the environment file slug name: .env.{$slug}
return 'local';
}
// Else if no environment variable found... it might be a production environment...
return 'production';
};Now that your environment is defined, you can configure it to your needs.
By default, the Themosis framework defines a local environment and loads the default local.php file stored in the config/environments folder:
<?php
/*----------------------------------------------------*/
// Local config
/*----------------------------------------------------*/
// Database
define('DB_NAME', getenv('DB_NAME'));
define('DB_USER', getenv('DB_USER'));
define('DB_PASSWORD', getenv('DB_PASSWORD'));
define('DB_HOST', getenv('DB_HOST') ? getenv('DB_HOST') : 'localhost');
// WordPress URLs
define('WP_HOME', getenv('WP_HOME'));
define('WP_SITEURL', getenv('WP_SITEURL'));
// Jetpack
define('JETPACK_DEV_DEBUG', true);
// Encoding
define('THEMOSIS_CHARSET', 'UTF-8');
// Development
define('SAVEQUERIES', true);
define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', true);
define('SCRIPT_DEBUG', true);
// Themosis framework
define('THEMOSIS_ERROR', true);
define('BS', true);This is the pre-configured local configuration file. You can add as many as you want configurations to this file. These are only available for your local environment.
Notice the removed constants
THEMOSIS_ERROR_REPORT,THEMOSIS_ERROR_DISPLAYandTHEMOSIS_ERROR_SHUTDOWNwhich are no longer used. The framework now integrates error reporting with the Whoops package.
Finally, note the BS constant which is mainly used inside the new theme to output BrowserSync script for your local development.
Some WordPress configurations are the same whatever environment you're using, like the authentication salts,...
Common configuration can be found into the shared.php file stored in the config directory.
In order to define shared configuration, you can edit this shared.php file. Fill in default configuration or add custom ones.
In order to finish our local configuration, open the shared.php file and fill in the authentication salts:
<?php
/*----------------------------------------------------*/
// Authentication unique keys and salts
/*----------------------------------------------------*/
define('AUTH_KEY', 'put your unique phrase here');
define('SECURE_AUTH_KEY', 'put your unique phrase here');
define('LOGGED_IN_KEY', 'put your unique phrase here');
define('NONCE_KEY', 'put your unique phrase here');
define('AUTH_SALT', 'put your unique phrase here');
define('SECURE_AUTH_SALT', 'put your unique phrase here');
define('LOGGED_IN_SALT', 'put your unique phrase here');
define('NONCE_SALT', 'put your unique phrase here');
By default, the bundled theme called themosis-theme is activated upon installation to avoid the famous "white screen of death". Please note that we encourage you to rename the theme to reflect your project. When you rename your theme, WordPress lost its tracks. Be sure to log in to the WordPress administration and activate your renamed theme upon installation.
Once your environment is setup, open your browser and start the default WordPress installation process.
You might be redirected directly to your home page upon installation. Please make sure to rename your theme folder before processing any longer.
Visit your project home page and you should be granted with a welcome message. Congratulations! You have installed WordPress and the Themosis framework.
To log into the WordPress admin screen use the
/loginURI. The Themosis framework default theme will always redirect non logged in users to the home page if you're trying to use the popular/wp-adminURI.
Read the framework guide
Made in Belgium