Skip to main content

Advanced cURLs for Site Migration

Use advanced cURL techniques to migrate and prepare your site for launch.


This section provides information on how to use cURL commands during the migration process, as well as commands to compare your old site to your newly migrated site on Pantheon.

The commands below show you how to:

  • Test a domain not yet resolved to Pantheon with advanced cURL techniques

  • Use the Pantheon Debugger

  • Suppress certificate errors

Test a Domain Not Resolved to Pantheon

It's important to verify that your site responds correctly to the given host name during the migration process. You can't test this if the DNS is not yet pointed at Pantheon.

A common way around this is to use the /etc/hosts file to change your local DNS resolution. Another way is to use cURL’s --resolve option, which provides a custom address for a specific host and port pair. The cURL --resolve request inserts the specified address into cURL's DNS cache. This overrides the DNS lookup and prevents the normally resolved IP address from being used.

For example, if you wanted to request myexamplesite.com from 23.185.0.1, you would run:

curl https://www.myexamplesite.com --resolve www.myexamplesite.com:443:23.185.0.1

If you want to compare your old site with your new site without making DNS changes, you would run:

diff <(curl -s https://myexamplesite.com) <(curl -s --resolve myexamplesite.com:443:23.185.0.1 https://mycoolwebsite.com)

This command shows line-by-line differences between the two sites while only resolving the second site from Pantheon’s platform using that domain.

Use the Pantheon Debugger

You can use the cURL -I -H option with Pantheon's Debug header to get additional information about a request.

curl -I -H "Pantheon-Debug:1" https://myexamplesite.com

This command shows the following header information:

HTTP/2 200
cache-control: public, max-age=3600
content-language: en
content-type: text/html; charset=utf-8
etag: W/"1620823485-0"
expires: Sun, 19 Nov 1978 05:00:00 GMT
last-modified: Wed, 12 May 2021 12:44:45 GMT        
link: <https://pantheon.io/>; rel="canonical"       
server: nginx
strict-transport-security: max-age=31622400
surrogate-key-raw:
x-drupal-cache: HIT
x-frame-options: SAMEORIGIN
x-pantheon-styx-hostname: styx-fe2-b-d65d59d6b-s7n8b
x-styx-req-id: e415f5fd-b31f-11eb-b9b0-0a6939d335f4 
date: Wed, 12 May 2021 13:17:50 GMT
x-served-by: cache-mdw17325-MDW, cache-fty21371-FTY 
x-cache: HIT, HIT
x-cache-hits: 1, 1
x-timer: S1620825471.689334,VS0,VE1
policy-doc-cache: HIT
policy-doc-surrogate-key: pantheon.io
pcontext-pdocclustering: on
pcontext-enforce-https: full
pcontext-request-restarts: 1
pcontext-backend: agcdn
vary: Accept-Encoding, Cookie, Cookie, Cookie
age: 1959
accept-ranges: bytes
via: 1.1 varnish, 1.1 varnish
content-length: 156572

Understanding Additional Header Information

cache-control: This header tells the browser how long it should cache the URL.

etag, expires, last-modified: Provides more information about the cache control mechanism, primarily for the browser side.

surrogate-key-raw: This is the cache key that Fastly uses to cache the content if it’s different from the URL path. If you’re using Pantheon’s Advanced Page Cache module/plugin, there will be values here, such as the Posts or Nodes that are included in a page. Modifying such values can easily clear the cache for any URLs that include those items.

x-served-by: Displays the Fastly data centers that your request traveled through to reach the appserver.

x-cache: This generally has the same number of values as served-by, and indicates a HIT or MISS for each point.

age: This shows how long the content has been cached. This generally reflects cache cleared from the Pantheon dashboard, as well as the cache limited by the cache control mechanisms listed above. In some cases, this value may exceed your expected max value. This is the result of the appserver responding with a 304 not modified error when Fastly checked for new content.

via: This indicates services in the response chain and the HTTPS protocol (not the version of the service) that was used to respond.

Suppress Certificate Errors

cURL uses a bundle of Certificate Authority (CA) public keys (CA certificates) to verify the SSL certificate by default.

The -k option tells cURL to skip certificate verification, including the server’s TLS certificate and CA certificates. If your SSL certificate is not yet provisioned, using the -k option will suppress errors and allow you to get results from your cURL commands.

If you are using SCP and SFTP for transfers, the -k option instructs cURL to skip the known hosts verification.

curl -k https://myexamplesite.com

More Resources