{"id":15634154,"url":"https://github.com/kovshenin/surge","last_synced_at":"2025-10-18T07:29:17.136Z","repository":{"id":38341513,"uuid":"393007402","full_name":"kovshenin/surge","owner":"kovshenin","description":"Surge is a very simple and fast page caching plugin for WordPress.","archived":false,"fork":false,"pushed_at":"2024-09-05T11:13:01.000Z","size":432,"stargazers_count":157,"open_issues_count":11,"forks_count":11,"subscribers_count":11,"default_branch":"main","last_synced_at":"2024-10-29T22:49:18.705Z","etag":null,"topics":["wordpress","wordpress-plugin","wordpress-plugins"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kovshenin.png","metadata":{"files":{"readme":"readme.txt","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-08-05T10:55:27.000Z","updated_at":"2024-10-25T21:53:52.000Z","dependencies_parsed_at":"2023-02-08T20:15:26.565Z","dependency_job_id":"d8113815-38c5-42f9-b8e7-ff12ceba39f0","html_url":"https://github.com/kovshenin/surge","commit_stats":{"total_commits":72,"total_committers":4,"mean_commits":18.0,"dds":0.04166666666666663,"last_synced_commit":"b9bbb79421a49761cf42f6dcb81cd1b5fad3c8db"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kovshenin%2Fsurge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kovshenin%2Fsurge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kovshenin%2Fsurge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kovshenin%2Fsurge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kovshenin","download_url":"https://codeload.github.com/kovshenin/surge/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243336935,"owners_count":20275193,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["wordpress","wordpress-plugin","wordpress-plugins"],"created_at":"2024-10-03T10:51:27.886Z","updated_at":"2025-10-18T07:29:17.115Z","avatar_url":"https://github.com/kovshenin.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"=== Surge ===\nContributors: kovshenin\nDonate link: https://github.com/kovshenin/surge\nTags: cache, performance, caching\nRequires at least: 5.7\nTested up to: 6.8\nRequires PHP: 7.3\nStable tag: 1.1.0\nLicense: GPLv3 or later\nLicense URI: https://www.gnu.org/licenses/gpl-3.0.en.html\n\nSurge is a very simple and fast page caching plugin for WordPress.\n\n== Description ==\n\nSurge generates and serves static HTML files for your WordPress site, causing quicker requests, faster load times and a shorter time to first byte (TTFB).\n\nSurge does not require configuration, and has no options. It works out of the box on any well-configured hosting platform. Cached files are stored on disk, and automatically invalidated when your site is updated.\n\nIn various load tests, Surge has shown to easily handle 1000-2500 requests per second at 100 concurrent, on a small single-core server with only 1 GB of RAM. That's over 70 times faster than a stock WordPress install.\n\n== Installation ==\n\nVia the WordPress Dashboard: navigate to Plugins - Add New. In the search bar type \"surge\" and hit Enter. Find the Surge plugin in the search results, hit Install, then Activate.\n\nManually: download the Surge plugin .zip file from WordPress.org. In your WordPress admin navigate to Plugins - Add New - Upload. Select the .zip file and hit Upload. Activate the plugin after upload is successful.\n\nManually via FTP: download the Surge plugin .zip file from WordPress.org, extract the archive, make sure the directory is called \"surge\". Use your FTP/SFTP client to upload the \"surge\" directory to wp-content/plugins. Then activate the plugin in your WordPress admin from the Plugins section.\n\nUsing WP-CLI: wp plugin install surge --activate\n\n== Frequently Asked Questions ==\n\n= Where is the plugin configuration screen? =\n\nThere isn't one.\n\n= How do I clear the cache? =\n\nToggle the plugin activation or run `wp surge flush` using WP-CLI.\n\n= Is my cache working? =\n\nVisit the Site Health screen under Tools in your WordPress dashboard. Common caching errors, like installation problems, etc. will appear there. Otherwise, open your site in an Incognito window to see the cached version. You could also look for the \"X-Cache\" header in the server response.\n\n= Why am I getting cache misses? =\n\nBelow are a few common reasons:\n\n* You are logged into your WordPress site\n* You have a unique cookie set in your browser\n* A unique query parameter will also cause a cache miss, except common marketing parameters, such as utm_campaign, etc.\n* Request methods outside of GET and HEAD are not cached\n\n= Can I exclude page X from being cached? =\n\nOf course. If you pass a \"Cache-Control: no-cache\" header (or max-age=0) the request will automatically be excluded from cache. Note that most WordPress plugins will already do this where necessary.\n\n= fpassthru() has been disabled for security reasons =\n\nIt seems like your hosting provider disabled the fpassthru() function, likely by mistake. This is a requirement for Surge. Please get in touch with them and kindly ask them to enable it.\n\n= How can I support Surge? =\n\nIf you like Surge, consider giving us a [star on GitHub](https://github.com/kovshenin/surge) and a review on WordPress.org.\n\n== Changelog ==\n\n= 1.1.0 =\n* Improved Multisite compatibility\n* Fixed occasional stat() warnings in cleanup routines\n* Fixed expiration by path being too broad\n* Added a filter for flush actions\n* Feature: added a simple events system for s-maxage and stale-while-revalidate support\n\n= 1.0.5 =\n* Fix woocommerce_product_title compatibility\n* Honor DONOTCACHEPAGE constant\n* Use built-in is_ssl() WordPress function for better compatibility\n\n= 1.0.4 =\n* Add a WP-CLI command to invalidate/flush page cache\n* Fix redirect loop with Core's redirect_canonical for ignore_query_vars\n* Fix warnings for requests with empty headers\n* Fix warnings when cron cleanup attempts to read a file that no longer exists\n* Add a filter to disable writing to wp-config.php\n\n= 1.0.3 =\n* Invalidate cache when posts_per_page is changed\n* Fix redirect loop with unknown query vars caused by Core's redirect_canonical\n* Ignore X-Cache and X-Powered-By headers from cache metadata\n* Allow multiple headers with the same name\n\n= 1.0.2 =\n* Fix PHP notice in invalidation\n* Protect against race conditions when writing flags.json\n* Add support for more post statuses in transition_post_status invalidation\n\n= 1.0.1 =\n* Add support for custom user configuration\n* Various invalidation enhancements and fixes\n* Remove advanced-cache.php when plugin is deactivated\n* Add a note about fpassthru() in FAQ\n* Minor fix in Site Health screen tests\n\n= 1.0.0 =\n* Anonymize requests to favicon.ico and robots.txt\n* Improve cache expiration, add cache expiration by path\n\n= 0.1.0 =\n* Initial release\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkovshenin%2Fsurge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkovshenin%2Fsurge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkovshenin%2Fsurge/lists"}