Every host and framework

Set up Constile on Symfony

Constile's gate runs in front of your pages. An AI agent fetching a page for a person gets an offer; people, search engines, and subscribers get your site as they do today.
Before you start
Sign up and add your site. Its page shows the site ID and secret these steps use, checks the install, and has Test my site. Rather have our team set it up with you? Select Get help installing on that page.
  1. Install the packageDownload constile-gate-php-0.6.0.zip into a packages folder in your app, then install it from there:
    composer config repositories.constile artifact ./packages
    composer require constile/gate:^0.6
    PHP 8.1 or later.
  2. Wrap your kernel
    use Constile\Gate\Symfony\Adapter;
    use Constile\Gate\Symfony\GateMiddleware;
    use Constile\Gate\SelfFetch;
    
    $app = new GateMiddleware($kernel, new Adapter(
        siteId: $_ENV['CONSTILE_SITE_ID'],
        secret: $_ENV['CONSTILE_SITE_SECRET'],
        networkUrl: $_ENV['CONSTILE_NETWORK_URL'],
        bypass: SelfFetch::derive($_ENV['CONSTILE_SITE_SECRET']),
        platform: 'symfony',
    ));
    $response = $app->handle($request);
  3. Set your site's settingsAdd these to .env.local, or to the server's environment.
    CONSTILE_SITE_ID=your-site-id
    CONSTILE_SITE_SECRET=your-site-secret
    CONSTILE_NETWORK_URL=https://constile.app
    Your site's page shows its ID, and shows the secret once, when you add the site.
  4. Check the installDeploy, then select Check install on your site's page. The network asks your domain for /.well-known/constile, and the gate answers with your site secret. Then Test my site shows what a person, a search crawler, and an AI agent each get.
The full guide covers every option, proxies and load balancers, and caches.

Turn it off

Fastest, from your dashboard: once the gate is installed, select Pause offers under Manage on your site's page. The network stops making offers, and the gate passes every request through within a minute. Nothing changes on your server.On your site: Set CONSTILE_DISABLED=1 in the app's environment and restart PHP if your host sets the environment only at start. The gate reads it on every request.To take it out: Take the gate out of your code, then run composer remove constile/gate.Off or paused, people, search crawlers, subscribers, and your other ads get your site exactly as before.