Some modules for Omeka Classic and Omeka S, such as CSV Import, Neatline and OHMS Import require that you explicitly specify the background PHP path to work properly. You can follow the steps below to adjust that setting.
Determining the PHP path to use
To find out what version of PHP your site is running on, start by checking the MultiPHP Manager in your cPanel. There, in the PHP Version column, you’ll see something along the lines of PHP 8.1 (ea-php81), which means you are using PHP 8.1. This is the PHP version you’ll need to specify as the background.php path in your Omeka config files. The paths for the PHP versions we offer are as follows:
- PHP 7.3 →
/usr/local/bin/ea-php73 - PHP 7.4 →
/usr/local/bin/ea-php74 - PHP 8.0 →
/usr/local/bin/ea-php80 - PHP 8.1 →
/usr/local/bin/ea-php81 - PHP 8.2 →
/usr/local/bin/ea-php82
Use the File Manager to navigate Omeka's install directory
Editing files can be done from within cPanel by using the File Manager:
Navigate to the folder where Omeka Classic or Omeka S is installed, which is likely public_html or the name of the domain or subdomain your site is installed to (ex: omeka.mycooldomain.com).
Edit the configuration file
Depending on if you are using Omeka Classic or Omeka S the file path and setting varies. For both applications, start by navigating from the Omeka install directory to the path specified below, then select the file and use the Edit button to edit the file.
Omeka Classic
For Omeka Classic, the setting is named background.php.path and you’ll find it in:
application/config/config.ini.
Omeka S
For Omeka S, the setting is named phpcli_path and you’ll find it in:
config/local.config.php