---
title: GitHub Update Caching Gateway
date: 2025-06-14T17:57:04Z
modified: 2025-06-15T09:54:17Z
permalink: "https://techarticles.co.uk/github-update-caching-gateway/"
type: post
status: publish
excerpt: ""
wpid: 5348
categories:
  - Automation
  - Coding
  - Plugins
timestamp: 2025-06-15T09:54:17Z
tags:
  - Automation
  - Coding
  - Plugins
---

I have been working on an update to the [UUPD](https://github.com/stingray82/uupd) which will officially version 1.2 and as well as all the updates that have been added in the past few months this allows for direct GitHub updates and means for a few of my GitHub only free plugins they should now be able to be updated straight from GitHub.

I have also created a simple gateway updater than checks the GitHub API and returns the bare minimum response the UUPD needs to an update this has several advantages but the most prominent one is I can include a Personal Access Token and that token can then increase checks from circa 60 per hour to 5000 per hour this may be necessary in the future for direct from GitHub updates, where I am heavily using those plugins on the same server / vps.

<?php // Load configuration $github\_user = ‘stingray82’; $token\_file = ‘github\_token.txt’; // GitHub token securely stored $cache\_dir = \_\_DIR\_\_ . ‘/cache’; $cache\_ttl = 3600; // 1 hour // Get slug and action $slug = $\_GET\[‘slug’\] ?? ”; $action = $\_GET\[‘action’\] ?? ”; $token = $\_GET\[‘token’\] ?? ”; if ($action !== ‘get\_metadata’ || !$slug) { http\_response\_code(400); echo json\_encode(\[‘error’ => ‘Invalid request’\]); exit; } // Optional: Validate token here… // Cache logic $cache\_file = “{$cache\_dir}/{$slug}.json”; if (file\_exists($cache\_file) && time() – filemtime($cache\_file) < $cache\_ttl) { echo file\_get\_contents($cache\_file); exit; } // Load GitHub token if (!file\_exists($token\_file)) { http\_response\_code(500); echo json\_encode(\[‘error’ => ‘Missing GitHub token’\]); exit; } $gh\_token = trim(file\_get\_contents($token\_file)); // Call GitHub API $api\_url = “https://api.github.com/repos/{$github\_user}/{$slug}/releases/latest”; $ch = curl\_init($api\_url); curl\_setopt\_array($ch, \[ CURLOPT\_RETURNTRANSFER => true, CURLOPT\_USERAGENT => ‘ReallyUsefulPlugins-Updater’, CURLOPT\_HTTPHEADER => \[ “Authorization: token {$gh\_token}”, “Accept: application/vnd.github+json” \] \]); $response = curl\_exec($ch); curl\_close($ch); $data = json\_decode($response, true); if (!isset($data\[‘tag\_name’\], $data\[‘assets’\]\[0\]\[‘browser\_download\_url’\])) { http\_response\_code(404); echo json\_encode(\[‘error’ => ‘No valid GitHub release found’\]); exit; } $version = ltrim($data\[‘tag\_name’\], ‘v’); $downloadUrl = $data\[‘assets’\]\[0\]\[‘browser\_download\_url’\]; $now = date(‘Y-m-d H:i:s’); $metadata = \[ ‘name’ => ucwords(str\_replace(‘-‘, ‘ ‘, $slug)), ‘version’ => $version, ‘author’ => ‘reallyusefulplugins.com’, ‘author\_homepage’ => ‘https://reallyusefulplugins.com’, ‘slug’ => $slug, ‘download\_url’ => $downloadUrl, ‘last\_updated’ => $now, ‘sections’ => \[ ‘description’ => ‘<p>GitHub release plugin</p>’, ‘changelog’ => ‘<p>Version ‘ . $version . ‘ from GitHub</p>’, \] \]; // Save to cache if (!file\_exists($cache\_dir)) mkdir($cache\_dir); file\_put\_contents($cache\_file, json\_encode($metadata)); header(‘Content-Type: application/json’); echo json\_encode($metadata); ```
<span class="line"><span style="color: #F97583"><?</span><span style="color: #79B8FF">php</span></span>
<span class="line"><span style="color: #6A737D">// Load configuration</span></span>
<span class="line"><span style="color: #E1E4E8">$github_user </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">'stingray82'</span><span style="color: #E1E4E8">;</span></span>
<span class="line"><span style="color: #E1E4E8">$token_file </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">'github_token.txt'</span><span style="color: #E1E4E8">;  </span><span style="color: #6A737D">// GitHub token securely stored</span></span>
<span class="line"><span style="color: #E1E4E8">$cache_dir   </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> </span><span style="color: #79B8FF">__DIR__</span><span style="color: #E1E4E8"> </span><span style="color: #F97583">.</span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">'/cache'</span><span style="color: #E1E4E8">;</span></span>
<span class="line"><span style="color: #E1E4E8">$cache_ttl   </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> </span><span style="color: #79B8FF">3600</span><span style="color: #E1E4E8">; </span><span style="color: #6A737D">// 1 hour</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A737D">// Get slug and action</span></span>
<span class="line"><span style="color: #E1E4E8">$slug   </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> $_GET[</span><span style="color: #9ECBFF">'slug'</span><span style="color: #E1E4E8">] </span><span style="color: #F97583">??</span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">''</span><span style="color: #E1E4E8">;</span></span>
<span class="line"><span style="color: #E1E4E8">$action </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> $_GET[</span><span style="color: #9ECBFF">'action'</span><span style="color: #E1E4E8">] </span><span style="color: #F97583">??</span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">''</span><span style="color: #E1E4E8">;</span></span>
<span class="line"><span style="color: #E1E4E8">$token  </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> $_GET[</span><span style="color: #9ECBFF">'token'</span><span style="color: #E1E4E8">] </span><span style="color: #F97583">??</span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">''</span><span style="color: #E1E4E8">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #F97583">if</span><span style="color: #E1E4E8"> ($action </span><span style="color: #F97583">!==</span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">'get_metadata'</span><span style="color: #E1E4E8"> </span><span style="color: #F97583">||</span><span style="color: #E1E4E8"> </span><span style="color: #F97583">!</span><span style="color: #E1E4E8">$slug) {</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #79B8FF">http_response_code</span><span style="color: #E1E4E8">(</span><span style="color: #79B8FF">400</span><span style="color: #E1E4E8">);</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #79B8FF">echo</span><span style="color: #E1E4E8"> </span><span style="color: #79B8FF">json_encode</span><span style="color: #E1E4E8">([</span><span style="color: #9ECBFF">'error'</span><span style="color: #E1E4E8"> </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">'Invalid request'</span><span style="color: #E1E4E8">]);</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #F97583">exit</span><span style="color: #E1E4E8">;</span></span>
<span class="line"><span style="color: #E1E4E8">}</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A737D">// Optional: Validate token here...</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A737D">// Cache logic</span></span>
<span class="line"><span style="color: #E1E4E8">$cache_file </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">"{</span><span style="color: #E1E4E8">$cache_dir</span><span style="color: #9ECBFF">}/{</span><span style="color: #E1E4E8">$slug</span><span style="color: #9ECBFF">}.json"</span><span style="color: #E1E4E8">;</span></span>
<span class="line"><span style="color: #F97583">if</span><span style="color: #E1E4E8"> (</span><span style="color: #79B8FF">file_exists</span><span style="color: #E1E4E8">($cache_file) </span><span style="color: #F97583">&&</span><span style="color: #E1E4E8"> </span><span style="color: #79B8FF">time</span><span style="color: #E1E4E8">() </span><span style="color: #F97583">-</span><span style="color: #E1E4E8"> </span><span style="color: #79B8FF">filemtime</span><span style="color: #E1E4E8">($cache_file) </span><span style="color: #F97583"><</span><span style="color: #E1E4E8"> $cache_ttl) {</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #79B8FF">echo</span><span style="color: #E1E4E8"> </span><span style="color: #79B8FF">file_get_contents</span><span style="color: #E1E4E8">($cache_file);</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #F97583">exit</span><span style="color: #E1E4E8">;</span></span>
<span class="line"><span style="color: #E1E4E8">}</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A737D">// Load GitHub token</span></span>
<span class="line"><span style="color: #F97583">if</span><span style="color: #E1E4E8"> (</span><span style="color: #F97583">!</span><span style="color: #79B8FF">file_exists</span><span style="color: #E1E4E8">($token_file)) {</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #79B8FF">http_response_code</span><span style="color: #E1E4E8">(</span><span style="color: #79B8FF">500</span><span style="color: #E1E4E8">);</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #79B8FF">echo</span><span style="color: #E1E4E8"> </span><span style="color: #79B8FF">json_encode</span><span style="color: #E1E4E8">([</span><span style="color: #9ECBFF">'error'</span><span style="color: #E1E4E8"> </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">'Missing GitHub token'</span><span style="color: #E1E4E8">]);</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #F97583">exit</span><span style="color: #E1E4E8">;</span></span>
<span class="line"><span style="color: #E1E4E8">}</span></span>
<span class="line"><span style="color: #E1E4E8">$gh_token </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> </span><span style="color: #79B8FF">trim</span><span style="color: #E1E4E8">(</span><span style="color: #79B8FF">file_get_contents</span><span style="color: #E1E4E8">($token_file));</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A737D">// Call GitHub API</span></span>
<span class="line"><span style="color: #E1E4E8">$api_url </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">"https://api.github.com/repos/{</span><span style="color: #E1E4E8">$github_user</span><span style="color: #9ECBFF">}/{</span><span style="color: #E1E4E8">$slug</span><span style="color: #9ECBFF">}/releases/latest"</span><span style="color: #E1E4E8">;</span></span>
<span class="line"><span style="color: #E1E4E8">$ch </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> </span><span style="color: #79B8FF">curl_init</span><span style="color: #E1E4E8">($api_url);</span></span>
<span class="line"><span style="color: #79B8FF">curl_setopt_array</span><span style="color: #E1E4E8">($ch, [</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #79B8FF">CURLOPT_RETURNTRANSFER</span><span style="color: #E1E4E8"> </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> </span><span style="color: #79B8FF">true</span><span style="color: #E1E4E8">,</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #79B8FF">CURLOPT_USERAGENT</span><span style="color: #E1E4E8">      </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">'ReallyUsefulPlugins-Updater'</span><span style="color: #E1E4E8">,</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #79B8FF">CURLOPT_HTTPHEADER</span><span style="color: #E1E4E8">     </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> [</span></span>
<span class="line"><span style="color: #E1E4E8">        </span><span style="color: #9ECBFF">"Authorization: token {</span><span style="color: #E1E4E8">$gh_token</span><span style="color: #9ECBFF">}"</span><span style="color: #E1E4E8">,</span></span>
<span class="line"><span style="color: #E1E4E8">        </span><span style="color: #9ECBFF">"Accept: application/vnd.github+json"</span></span>
<span class="line"><span style="color: #E1E4E8">    ]</span></span>
<span class="line"><span style="color: #E1E4E8">]);</span></span>
<span class="line"><span style="color: #E1E4E8">$response </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> </span><span style="color: #79B8FF">curl_exec</span><span style="color: #E1E4E8">($ch);</span></span>
<span class="line"><span style="color: #79B8FF">curl_close</span><span style="color: #E1E4E8">($ch);</span></span>
<span class="line"></span>
<span class="line"><span style="color: #E1E4E8">$data </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> </span><span style="color: #79B8FF">json_decode</span><span style="color: #E1E4E8">($response, </span><span style="color: #79B8FF">true</span><span style="color: #E1E4E8">);</span></span>
<span class="line"><span style="color: #F97583">if</span><span style="color: #E1E4E8"> (</span><span style="color: #F97583">!</span><span style="color: #79B8FF">isset</span><span style="color: #E1E4E8">($data[</span><span style="color: #9ECBFF">'tag_name'</span><span style="color: #E1E4E8">], $data[</span><span style="color: #9ECBFF">'assets'</span><span style="color: #E1E4E8">][</span><span style="color: #79B8FF">0</span><span style="color: #E1E4E8">][</span><span style="color: #9ECBFF">'browser_download_url'</span><span style="color: #E1E4E8">])) {</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #79B8FF">http_response_code</span><span style="color: #E1E4E8">(</span><span style="color: #79B8FF">404</span><span style="color: #E1E4E8">);</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #79B8FF">echo</span><span style="color: #E1E4E8"> </span><span style="color: #79B8FF">json_encode</span><span style="color: #E1E4E8">([</span><span style="color: #9ECBFF">'error'</span><span style="color: #E1E4E8"> </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">'No valid GitHub release found'</span><span style="color: #E1E4E8">]);</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #F97583">exit</span><span style="color: #E1E4E8">;</span></span>
<span class="line"><span style="color: #E1E4E8">}</span></span>
<span class="line"></span>
<span class="line"><span style="color: #E1E4E8">$version     </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> </span><span style="color: #79B8FF">ltrim</span><span style="color: #E1E4E8">($data[</span><span style="color: #9ECBFF">'tag_name'</span><span style="color: #E1E4E8">], </span><span style="color: #9ECBFF">'v'</span><span style="color: #E1E4E8">);</span></span>
<span class="line"><span style="color: #E1E4E8">$downloadUrl </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> $data[</span><span style="color: #9ECBFF">'assets'</span><span style="color: #E1E4E8">][</span><span style="color: #79B8FF">0</span><span style="color: #E1E4E8">][</span><span style="color: #9ECBFF">'browser_download_url'</span><span style="color: #E1E4E8">];</span></span>
<span class="line"><span style="color: #E1E4E8">$now         </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> </span><span style="color: #79B8FF">date</span><span style="color: #E1E4E8">(</span><span style="color: #9ECBFF">'Y-m-d H:i:s'</span><span style="color: #E1E4E8">);</span></span>
<span class="line"></span>
<span class="line"><span style="color: #E1E4E8">$metadata </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> [</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #9ECBFF">'name'</span><span style="color: #E1E4E8">         </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> </span><span style="color: #79B8FF">ucwords</span><span style="color: #E1E4E8">(</span><span style="color: #79B8FF">str_replace</span><span style="color: #E1E4E8">(</span><span style="color: #9ECBFF">'-'</span><span style="color: #E1E4E8">, </span><span style="color: #9ECBFF">' '</span><span style="color: #E1E4E8">, $slug)),</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #9ECBFF">'version'</span><span style="color: #E1E4E8">      </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $version,</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #9ECBFF">'author'</span><span style="color: #E1E4E8">       </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">'reallyusefulplugins.com'</span><span style="color: #E1E4E8">,</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #9ECBFF">'author_homepage'</span><span style="color: #E1E4E8"> </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">'https://reallyusefulplugins.com'</span><span style="color: #E1E4E8">,</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #9ECBFF">'slug'</span><span style="color: #E1E4E8">         </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $slug,</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #9ECBFF">'download_url'</span><span style="color: #E1E4E8"> </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $downloadUrl,</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #9ECBFF">'last_updated'</span><span style="color: #E1E4E8"> </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $now,</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #9ECBFF">'sections'</span><span style="color: #E1E4E8">     </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> [</span></span>
<span class="line"><span style="color: #E1E4E8">        </span><span style="color: #9ECBFF">'description'</span><span style="color: #E1E4E8"> </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">'<p>GitHub release plugin</p>'</span><span style="color: #E1E4E8">,</span></span>
<span class="line"><span style="color: #E1E4E8">        </span><span style="color: #9ECBFF">'changelog'</span><span style="color: #E1E4E8">   </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">'<p>Version '</span><span style="color: #E1E4E8"> </span><span style="color: #F97583">.</span><span style="color: #E1E4E8"> $version </span><span style="color: #F97583">.</span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">' from GitHub</p>'</span><span style="color: #E1E4E8">,</span></span>
<span class="line"><span style="color: #E1E4E8">    ]</span></span>
<span class="line"><span style="color: #E1E4E8">];</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A737D">// Save to cache</span></span>
<span class="line"><span style="color: #F97583">if</span><span style="color: #E1E4E8"> (</span><span style="color: #F97583">!</span><span style="color: #79B8FF">file_exists</span><span style="color: #E1E4E8">($cache_dir)) </span><span style="color: #79B8FF">mkdir</span><span style="color: #E1E4E8">($cache_dir);</span></span>
<span class="line"><span style="color: #79B8FF">file_put_contents</span><span style="color: #E1E4E8">($cache_file, </span><span style="color: #79B8FF">json_encode</span><span style="color: #E1E4E8">($metadata));</span></span>
<span class="line"></span>
<span class="line"><span style="color: #79B8FF">header</span><span style="color: #E1E4E8">(</span><span style="color: #9ECBFF">'Content-Type: application/json'</span><span style="color: #E1E4E8">);</span></span>
<span class="line"><span style="color: #79B8FF">echo</span><span style="color: #E1E4E8"> </span><span style="color: #79B8FF">json_encode</span><span style="color: #E1E4E8">($metadata);</span></span>
<span class="line"></span>
```PHP

I’ve now also decided to test this out on one of my MainWP plugins the first which will use this will be **[MainWP-Bridge-to-Cloudflare-Bridge](https://github.com/stingray82/MainWP-Bridge-to-Cloudflare-Bridge)** which will be pushed to V1.2 today and over the next week or so will slowly move up to V1.3 the purpose for this will be to test the updating directly with github through the gateway and test the caching system

I will add a new article once I am done with testing with my new plugin deploy.bat which allows direct GitHub deployment and to my local file for my wp-update-server instance via [syncbackpro](https://ta0.uk/syncbackpro) which will also form part of the above testing.

It does the following items

1. Asks you to confirm the version number
2. Name of the plugin
3. Description of the plugin
4. Required PHP and WP versions
5. Tested Up to Version (defaulting to the latest)
6. it then auto generates a readme file based off of the changelog and the fixed static data
7. it then commits it with a version XXXX release message to github
8. Zips it up and depending on the setup (private repo or github repo) will then either move the zip file for syncbackpro to upload or push a release and upload the zip file to github

Early testing seems to indicate I can push a simple version update in less than 30 seconds from my local machine with the update being available almost instantly regardless of repo type