Reference

Guide

remote

Overrides the defaults for requests to remote servers

This option defines global default values for all requests that are made with the Kirby\Toolkit\Remote class.

Example

return [
    'remote' => [
        'agent'   => 'My Awesome Site',
        'timeout' => 20
    ]
];

Configuring the list of allowed certificate authorities (CAs) for HTTPS requests

Kirby ships with a CA bundle based on the Mozilla CA list. We keep that CA bundle up-to-date with new Kirby releases.

The CA bundle is used whenever a request to an HTTPS destination is made.

If you want to use a different CA bundle or disable verification completely (not recommended!), you can set the remote.ca option:

<?php

return [
    'remote' => [
        'ca' => ...
    ]
];

Options are:

  • An absolute path to a CA file in .pem format
  • An absolute path to a CA directory with certificate files that cURL can understand
  • The special value Remote::CA_INTERNAL for Kirby's internal CA (default)
  • The special value Remote::CA_SYSTEM to use the CA bundle that is configured in php.ini
  • false to disable TLS verification completely (not recommended!)