External keys

A private file requires an external key on the server where it runs (in addition to the Loader). You provide this key in one of two ways: an environment variable or a php.ini setting.

When you protect a file as private in Oxrion Cloud, you’ll be given the external key value to use. Configure it on the target server using either method below.

Option 1: Environment variable

Set an environment variable on the server. This is often the most convenient method for containerized or modern hosting setups.

The variable name and value are provided to you when you create the protected file in Oxrion Cloud. Set it the way your environment normally defines variables (for example, in your service configuration or container environment).

Option 2: php.ini

Alternatively, you can provide the key through a setting in your php.ini. Use this when setting environment variables isn’t practical for your hosting.

After adding the setting, restart your web server or PHP service so it takes effect.

Custom license directory (optional)

If your deployment keeps license files (.lic) somewhere other than next to your PHP files, you can tell the Loader where to look using the oxrion_loader.license_dir setting in php.ini:

oxrion_loader.license_dir = "/path/to/licenses"

By default, no configuration is needed — the Loader looks for the license file next to the protected .php file automatically.