Skip to content
PHP Proxy html2canvas
Branch: master
Clone or download
brcontainer Version 1.1.2
- Fixed "ternary operator"
- Fixed bugs and code review (1.1.1 version)
- Fixed bug in constants (1.1.0 version)
- Improved examples
Latest commit aa05670 Jan 6, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples Version 1.1.2 Jan 6, 2019
.gitignore Version 1.0.0 Jul 29, 2018
CHANGELOG.html Version 1.0.0 Jul 29, 2018 Version 1.1.2 Jan 6, 2019
LICENSE Update LICENSE Sep 25, 2016
README.html Version 1.1.2 Jan 6, 2019 Version 1.1.2 Jan 6, 2019
html2canvasproxy.php Version 1.1.2 Jan 6, 2019


PHP Proxy html2canvas

This script allows you to use html2canvas.js with different servers, ports and protocols (http, https), preventing to occur "tainted" when exporting the <canvas> for image.

Others scripting language

You do not use PHP, but need html2canvas working with proxy, see other proxies:

Problems and solutions

When adding an image that belongs to another domain in <canvas> and after that try to export the canvas for a new image, a security error occurs (actually occurs is a security lock), which can return the error:

SecurityError: DOM Exception 18

Error: An attempt was made to break through the security policy of the user agent.

If using Google Maps (or google maps static) you can get this error in console:

Google Maps API error: MissingKeyMapError

You need get a API Key in:

If get this error:

Access to Image at 'file:///...' from origin 'null' has been blocked by CORS policy: Invalid response. Origin 'null' is therefore not allowed access.

Means that you are not using an HTTP server, html2canvas does not work over the "file:///" protocol, use Apache, Nginx or IIS with PHP for work.


I ask you to follow me or "star" my repository to track updates

Run script in Cross-domain (data URI scheme)

(See details:

Note: Enable cross-domain in proxy server can consume more memory, but can be faster in execution it performs only one request at the proxy server.

Note: If the file html2canvasproxy.php is in the same domain that your project, you do not need to enable this option.

Note: Disable the "cross-domain" does not mean you will not be able to capture images from different servers, in other words, the "cross-domain" here refers to "html2canvas.js" (not necessarily the javascript file, but the place where runs) and the "html2canvas.php" are in different domains, the "cross-domain" here refers domain.

In some cases you may want to use this html2canvasproxy.php on a specific server, but the "html2canvas.js" and another server, this would cause problems in your project with the security causing failures in execution. In order to use security just set in the html2canvasproxy.php:

Enable data uri scheme for use proxy for all servers:

define('H2CP_DATAURI', true);

Disable data uri scheme:

define('H2CP_DATAURI', false);


Definition Description
define('H2CP_PATH', 'cache'); Folder where the images are saved
define('H2CP_PERMISSION', 0666); Set forlder permission (use 644 or 666 for remove execution for prevent sploits)
define('H2CP_CACHE', 60 * 5 * 1000); Limit access-control and cache in seconds, define 0/false/null/-1 to not use "http header cache"
define('H2CP_TIMEOUT', 20); Timeout from load Socket
define('H2CP_MAX_LOOP', 10); Configure loop limit for redirects (location header)
define('H2CP_DATAURI', false); Enable use of "data URI scheme"
define('H2CP_PREFER_CURL', true); Prefer curl if avaliable or disable
define('H2CP_SSL_VERIFY_PEER', false); Set false for disable SSL checking or true for enable (require config PHP.INI with curl.cainfo=/path/to/cacert.pem). You can set path manualy like this: define('H2CP_SSL_VERIFY_PEER', '/path/to/cacert.pem');
define('H2CP_ALLOWED_DOMAINS', '*'); * allow all domains, for subdomains use like this *, for fixed domains use , ',' (string separed by commas)
define('H2CP_ALLOWED_PORTS', '80,443'); Config allowed ports (string separed by commas)


Note: Requires PHP5+

<!DOCTYPE html>
        <meta charset="utf-8">
        <title>html2canvas php proxy</title>
        <script src="html2canvas.js"></script>
        (function() {
            window.onload = function(){
                html2canvas(document.body, {
                    "logging": true, //Enable log (use Web Console for get Errors and Warnings)
                    "proxy": "html2canvasproxy.php",
                    "onrendered": function (canvas) {
                        var img = new Image();
                        img.onload = function() {
                            img.onload = null;
                        img.onerror = function() {
                            img.onerror = null;
                            if(window.console.log) {
                                window.console.log("Not loaded image from canvas.toDataURL");
                            } else {
                                alert("Not loaded image from canvas.toDataURL");
                        img.src = canvas.toDataURL("image/png");
            <img alt="google maps static" src=",-73.998672&amp;zoom=12&amp;size=800x600&amp;maptype=roadmap&amp;sensor=false">

Using Web Console

If you have any problems with the script recommend to analyze the log use the Web Console from your browser:

Get NetWork results:

An alternative is to diagnose problems accessing the link directly:


Replace [DOMAIN] by your domain (eg. and replace [PATH] by your project folder (eg. project-1/test), something like:



Changelog moved to

Next versions

Details of future versions are being studied, in other words, can happen as can be forsaken ideas. The ideas here are not ready or are not public in the main script, are only suggestions. You can offer suggestions on issues.

  • Etag cache browser for use HTTP 304 (resources are reusable, avoiding unnecessary downloads)
  • Cache from SOCKET, if not specified header cache in SOCKET, then uses settings by DEFINE();
  • Rewrinte script using PSR-4
  • Support to composer
You can’t perform that action at this time.