Difference between revisions of "Changing Timezone"

From WHMCS Documentation

 
(15 intermediate revisions by 4 users not shown)
Line 1: Line 1:
The time under which your WHMCS installation will run is based upon the server clock and the timezone setting in your PHP configuration. Therefore to change the time displayed in WHMCS there are two options:
+
===Setting the timezone WHMCS uses===
  
#Change the server clock directly
+
The time under which your WHMCS installation will run is based on the server clock and the timezone setting in your PHP configuration. If the time displayed in WHMCS is incorrect, there are two options for correcting it:
#Edit the PHP configuration specifying a different timezone.
 
  
Changing the server clock may not be desirable if clients are hosted on the server and would require root access, so option 2 is the most viable for the majority  of users. A number of hosting providers allow the PHP configuration to be changed on an individual directory by creating a php.ini file within the WHMCS directory. In that situation the following line could be added:
+
*Change the server clock directly
 +
*Edit the PHP configuration on the server, specifying a different timezone.
  
<source lang="php">
+
Changing the server clock may not be desirable if you host clients on the server. It also requires <tt>root</tt> access, so the second option is best for the majority  of users. Some hosting providers allow you to change the PHP configuration on an individual directory by creating a <tt>php.ini</tt> file within the WHMCS directory. In that situation, you could add the following line:
 +
 
 +
<div class="source-cli">
 
date.timezone=Europe/London
 
date.timezone=Europe/London
</source>
+
</div>
 +
 
 +
For a full list of the available timezone localities you can use, see [http://www.php.net/manual/en/timezones.php the PHP list of timezones].
 +
 
 +
Contact your hosting provider or server administrator if you are unsure of how to customise the PHP configuration of your server.
 +
 
 +
===Timezone the cron operates under===
 +
 
 +
In most cases, the PHP configuration for your WHMCS installation is different than the one that you use on the command line. It's important to ensure the timezone WHMCS's PHP configuration uses is the same as the one in the PHP configuration the command line uses, and, by extension, the PHP configuration that the cron job is using.
 +
 
 +
If this is different, you will find that your cron job is executing at an unexpected or different time from the setting at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Automation_Settings|Automation Settings]]''' or, prior to WHMCS 8.0, '''Setup > Automation Settings'''.
 +
 
 +
To check this, run the following command at the server command line while logged in as the same user under whom the cron job is running:
  
For a full list of the available timezone localities you can use, please refer to http://www.php.net/manual/en/timezones.php
+
<div class="source-cli">
 +
php -ini | grep "date.timezone"
 +
</div>
  
Please contact your hosting provider/server admin if you are unsure how to customise the PHP configuration of your server.
+
You can compare the output of this command to the <tt>date.timezone</tt> set in the PHP configuration your WHMCS installation is using by navigating to '''Utilities > System > [[PHP Info]]'''. If they are different, you will need to work with your hosting provider or server administrator to set the same <tt>date.timezone</tt> in the PHP configuration your WHMCS installation is using and the one for the command line on the server.

Latest revision as of 18:51, 19 April 2022

Setting the timezone WHMCS uses

The time under which your WHMCS installation will run is based on the server clock and the timezone setting in your PHP configuration. If the time displayed in WHMCS is incorrect, there are two options for correcting it:

  • Change the server clock directly
  • Edit the PHP configuration on the server, specifying a different timezone.

Changing the server clock may not be desirable if you host clients on the server. It also requires root access, so the second option is best for the majority of users. Some hosting providers allow you to change the PHP configuration on an individual directory by creating a php.ini file within the WHMCS directory. In that situation, you could add the following line:

date.timezone=Europe/London

For a full list of the available timezone localities you can use, see the PHP list of timezones.

Contact your hosting provider or server administrator if you are unsure of how to customise the PHP configuration of your server.

Timezone the cron operates under

In most cases, the PHP configuration for your WHMCS installation is different than the one that you use on the command line. It's important to ensure the timezone WHMCS's PHP configuration uses is the same as the one in the PHP configuration the command line uses, and, by extension, the PHP configuration that the cron job is using.

If this is different, you will find that your cron job is executing at an unexpected or different time from the setting at Configuration () > System Settings > Automation Settings or, prior to WHMCS 8.0, Setup > Automation Settings.

To check this, run the following command at the server command line while logged in as the same user under whom the cron job is running:

php -ini | grep "date.timezone"

You can compare the output of this command to the date.timezone set in the PHP configuration your WHMCS installation is using by navigating to Utilities > System > PHP Info. If they are different, you will need to work with your hosting provider or server administrator to set the same date.timezone in the PHP configuration your WHMCS installation is using and the one for the command line on the server.