PHPackages frdl/remote-psr4 - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [PSR & Standards](/categories/psr-standards) 4. / 5. frdl/remote-psr4 ActiveLibrary[PSR & Standards](/categories/psr-standards) frdl/remote-psr4 ================ An php psr4 Autoloader which is autoloading from a remote server. v1.2.0(2y ago)326624MITPHPPHP >=7.2 | >=8.0 Since May 7Pushed 2mo ago1 watchersCompare [ Source](https://github.com/frdl/remote-psr4)[ Packagist](https://packagist.org/packages/frdl/remote-psr4)[ Docs](https://webfan.de/install/)[ Fund](https://domainundhomepagespeicher.de)[ Fund](https://webfan.de/sponsor-me/)[ RSS](/packages/frdl-remote-psr4/feed)WikiDiscussions master Synced today READMEChangelog (10)DependenciesVersions (33)Used By (4) remote-psr4 =========== [](#remote-psr4) An php **PSR-4**[\[?\]](https://www.php-fig.org/psr/psr-4/) Autoloader `Client` which is autoloading from one or more remote servers. With remote **Classmap** and **Aliases**. ### Server? [](#server) If you want to build an `API Server` for this client, you can install my Package [`frdl/codebase`](https://github.com/frdl/codebase). This is recommended for larger projects, **please use [my API Server](https://webfan.de/install/) only for testing, if want to use it productionaly or need a larger amount of load, please contact me!**You can also [contact me](https://startforum.de/u/till.wehowski/about) if you need any help with my packages, or if you need a [webhosting plan](https://domainundhomepagespeicher.de/)! Optionaly you can [configure the client](#with-custom-configuration), e.g. to load from githubs **without a central server**. Usage ----- [](#usage) ``` $loader = \frdl\implementation\psr4\RemoteAutoloader::getInstance('03.webfan.de', true, 'latest', true); ``` ...or... With (custom) configuration --------------------------- [](#with-custom-configuration) - Classmap (with PSR4 and Alias) - Cache Settings ``` $config = [ 'FRDL_UPDATE_CHANNEL' => 'latest', // stable | latest 'FRDL_REMOTE_PSR4_CACHE_DIR'=> \sys_get_temp_dir().\DIRECTORY_SEPARATOR. \get_current_user() .\DIRECTORY_SEPARATOR.'.frdl'.\DIRECTORY_SEPARATOR.'runtime'.\DIRECTORY_SEPARATOR.'cache'.\DIRECTORY_SEPARATOR .'classes'.\DIRECTORY_SEPARATOR.'psr4'.\DIRECTORY_SEPARATOR, 'FRDL_REMOTE_PSR4_CACHE_LIMIT'=> 24 * 60 * 60, ]; // $workspace is the DEFAULT Psr4 Server // e.g.: $workspace = 'https://webfan.de/install/'. $config['FRDL_UPDATE_CHANNEL'].'/?source=${class}&salt=${salt}&source-encoding=b64' $loader = call_user_func(function($config,$workspace){ return \frdl\implementation\psr4\RemoteAutoloaderApiClient::getInstance($workspace, false, $config['FRDL_UPDATE_CHANNEL'], false, false, /*Classmap (with PSR4 and Alias)*/ [ // (CLASSMAP) Concrete Classes: \frdlweb\Thread\ShutdownTasks::class => 'https://raw.githubusercontent.com/frdl/shutdown-helper/master/src/ShutdownTasks.php', \Webfan\Webfat\Jeytill::class => 'https://raw.githubusercontent.com/frdl/webfat-jeytill/main/src/Jeytill.php', // (PSR4) NAMESPACES = \\ at the end: 'frdl\\Proxy\\' => 'https://raw.githubusercontent.com/frdl/proxy/master/src/${class}.php?cache_bust=${salt}', // ALIAS = @ as first char: '@Webfan\\Autoloader\\Remote' => __CLASS__, // ALIAS works with PSR4-Namespace too: '@BetterReflection\\'=>'Roave\BetterReflection\\', //Versions at Webfan: // Default/Fallback Versions Server: \webfan\hps\Format\DataUri::class => 'https://webfan.de/install/?salt=${salt}&source=webfan\hps\Format\DataUri', // Stable/Current Versions Server: //\webfan\hps\Format\DataUri::class => 'https://webfan.de/install/stable/?salt=${salt}&source=webfan\hps\Format\DataUri', // Latest/Beta Versions Server: // \webfan\hps\Format\DataUri::class => 'https://webfan.de/install/latest/?salt=${salt}&source=webfan\hps\Format\DataUri', ], $config['FRDL_REMOTE_PSR4_CACHE_DIR'], $config['FRDL_REMOTE_PSR4_CACHE_LIMIT'] ); }, $config,'https://webfan.de/install/'. $config['FRDL_UPDATE_CHANNEL'].'/?source=${class}&salt=${salt}&source-encoding=b64'); ``` *more examples...* ``` /** More Examples: */ $loader->withClassmap([ //Alias: '@'.\BetterReflection\Reflection\ReflectionFunction::class => \Roave\BetterReflection\BetterReflection::class, '@'.\BetterReflection\SourceLocator\Exception\TwoClosuresOneLine::class => \Roave\BetterReflection\SourceLocator\Exception\TwoClosuresOnSameLine::class, \Webfan\Webfat\MainModule::class => 'https://raw.githubusercontent.com/frdl/recommendations/master/src/Webfan/Webfat/MainModule.php?cache_bust=${salt}', //Conrete class AND namespace: ORDER matters! //Classmaps SHOULD be sorted DESC in most cases, CLASS should be listed BEFORE namespace if equal FQN. \Webfan\Webfat\Module::class => 'https://raw.githubusercontent.com/frdl/recommendations/master/src/Webfan/Webfat/Module.php?cache_bust=${salt}', 'Webfan\Webfat\Module\\' => 'https://raw.githubusercontent.com/frdl/recommendations/master/src/Webfan/Webfat/Module/${class}.php?cache_bust=${salt}', 'Webfan\Webfat\Intent\\' => 'https://raw.githubusercontent.com/frdl/recommendations/master/src/Webfan/Webfat/Intent/${class}.php?cache_bust=${salt}', \Pimple::class => 'https://raw.githubusercontent.com/silexphp/Pimple/1.1/lib/Pimple.php', 'Task\Plugin\Console\\' => 'https://github.com/taskphp/console/blob/00bfa982c4502938ca0110d2f23c5cd04ffcbcc3/src/${class}.php?cache_bust=${salt}', 'Task\\' => 'https://raw.githubusercontent.com/taskphp/task/7618739308ba484b5f90a83d5e1a44e1d90968d2/src/${class}.php?cache_bust=${salt}', '@BetterReflection\\'=>'Roave\BetterReflection\\', ]); ``` ### Register Autoloader [](#register-autoloader) ``` $loader->register(false); // Prepend autoloader to autoloader-stack: // $loader->register(true); ``` **Prepend Autoloader:** If you like to prepend the autoloader you have to set the public static variable *allwaysAppendAutoloader* to *false*, **before** registering the autoloader! ``` public static $alwaysAppendLoader = true; ``` ``` \frdl\implementation\psr4\RemoteAutoloader::$alwaysAppendLoader = $loader::$alwaysAppendLoader = false; $loader->register(true); ``` This is **not recommended** as this loader loads from remote, for performance you should prefer your local classes (in production e.g.). With (custom) validators ------------------------ [](#with-custom-validators) [See methods:](https://github.com/frdl/remote-psr4/blob/master/src/implementations/autoloading/RemoteAutoloaderApiClient.php) - ->withBeforeMiddleware() - ->withAfterMiddleware() - ->withWebfanWebfatDefaultSettings() ``` //... $publicKeyChanged = false; $increaseTimelimit = true; $setPublicKey = function($baseUrl,$expFile, $pubKeyFile){ if(file_exists($expFile)){ $expires = intval(file_get_contents($expFile)); }else{ $expires = 0; } if($expires > 0 && ($expires === time() || ($expires > time() - 3 && $expires < time() + 3))){ sleep(3); } if($expires [ 'method'=>'GET', //'header'=>"Accept-Encoding: deflate, gzip\r\n", ], ]; $context = stream_context_create($opts); $key = file_get_contents($baseUrl.'source=@server.key', false, $context); foreach($http_response_header as $i => $header){ $h = explode(':', $header); if('x-frdlweb-source-expires' === strtolower(trim($h[0]))){ file_put_contents($expFile, trim($h[1]) ); break; } } file_put_contents($pubKeyFile, $key); } }; $getDefaultValidatorForUrl = function($baseUrl, $cacheDir, $increaseTimelimit = true) use($setPublicKey, &$publicKeyChanged) { $expFile = rtrim($cacheDir, '\\/ ') . \DIRECTORY_SEPARATOR.'validator-'.sha1($baseUrl).strlen($baseUrl).'.expires.txt'; $pubKeyFile = rtrim($cacheDir, '\\/ ') . \DIRECTORY_SEPARATOR.'validator-'.sha1($baseUrl).strlen($baseUrl).'.public-key.txt'; $setPublicKey($baseUrl,$expFile, $pubKeyFile); $condition = function($url, &$loader, $class) use($baseUrl, $increaseTimelimit){ if($increaseTimelimit){ set_time_limit(min(180, intval(ini_get('max_execution_time')) + 90)); } if($baseUrl === substr($url, 0, strlen($baseUrl) ) ){ return true; }else{ return false; } }; $cb = null; $filter = function($code, &$loader, $class, $c = 0) use(&$cb, $baseUrl, $expFile, $pubKeyFile, $setPublicKey, &$publicKeyChanged) { $c++; $sep = 'X19oYWx0X2NvbXBpbGVyKCk7'; $my_signed_data=$code; $public_key = file_get_contents($pubKeyFile); list($plain_data,$sigdata) = explode(base64_decode($sep), $my_signed_data, 2); list($nullVoid,$old_sig_1) = explode("----SIGNATURE:----", $sigdata, 2); list($old_sig,$ATTACHMENT) = explode("----ATTACHMENT:----", $old_sig_1, 2); $old_sig = base64_decode($old_sig); $ATTACHMENT = base64_decode($ATTACHMENT); if(empty($old_sig)){ return new \Exception("ERROR -- unsigned data"); } \openssl_public_decrypt($old_sig, $decrypted_sig, $public_key); $data_hash = sha1($plain_data.$ATTACHMENT).substr(str_pad(strlen($plain_data.$ATTACHMENT).'', 128, strlen($plain_data.$ATTACHMENT) % 10, \STR_PAD_LEFT), 0, 128); if($decrypted_sig === $data_hash && strlen($data_hash)>0){ return $plain_data; }else{ if(!$publicKeyChanged && $c withAfterMiddleware($validator[0], $validator[1]); } $loader->withBeforeMiddleware(function($class, &$loader){ switch($class){ case \DI\Compiler\Compiler::class : $aDir = dirname($loader->file($class)); if(!is_dir($aDir)){ mkdir($aDir, 0755, true); } $aFile = $aDir.\DIRECTORY_SEPARATOR.'Template.php'; if(!file_exists($aFile)){ file_put_contents($aFile, file_get_contents('https://raw.githubusercontent.com/PHP-DI/PHP-DI/master/src/Compiler/Template.php')); } return true; break; default: return true; break; } /* return true; return false to skip this autoloader, return any/VOID to continue */ }); //... ``` Presets per App and PHP Version ------------------------------- [](#presets-per-app-and-php-version) To bundle presets and cache them, to load faster in the next requests you can use the method - **->getClassmapFor**The Webfan API provides an endpoint to fetch bundled classmaps with the classes of an app/group and for a specific `PHP Version`. Currently Frdlweb will possible deprecate PHP 7 support for new products, but possible will support >=7+ and >=8+. The $version parameter should be enum of `latest`, `stable` and `legacy`. The $app parameter `default` or `*` bundles most of the Framework classes, further you currently can specify the apps - io4 - frdl/codebase | codebase - webfan | webfat | webfan-website | webfan-webfat ``` public function getClassmapFor(string $app, string $version, string $phpVersion = \PHP_VERSION, int | bool $cache = true) : array | bool ``` Requsts the following API endpoint: ` curl -X 'GET' '' -H 'accept: */*' ` A successful response looks like (classmap in result member) ``` { "code": 200, "message": "Your (remote-fetcher-) classmap was generated in the result property.", "for": { "app": "default", "version": "latest", "php_version": "8.2" }, "result": { "@frdl\\Facades": "Webfan\\FacadesManager", "Webfan\\ComposerAdapter\\": "https://raw.githubusercontent.com/frdl/composer-adapter/master/src/${class}.php?cache_bust=${salt}", "Webfan\\Codebase\\Server\\BundleExportHelper": "https://webfan.de/install/?source=Webfan\\Codebase\\Server\\BundleExportHelper&salt=${salt}", "WMDE\\VueJsTemplating\\": "https://raw.githubusercontent.com/wmde/php-vuejs-templating/2.0.0/src/${class}.php?cache_bust=${salt}", " ... ": " ... " } } ``` To load the classmap corresponding to the PHP version you are running, from cache or API, and attatch the classmaps autoload definitions to the $loader immediately, you can use the method - **->withClassmapFor** ``` withClassmapFor(string $app, string $version, string $phpVersion = \PHP_VERSION, int | bool $cache = true) ``` ### Health Score 43 — FairBetter than 89% of packages Maintenance56 Moderate activity, may be stable Popularity16 Limited adoption so far Community14 Small or concentrated contributor base Maturity72 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~39 days Recently: every ~93 days Total 32 Last Release 1019d ago Major Versions v0.3.2 → v1.0.02022-11-26 PHP version history (4 changes)v0.9.0PHP >=5.3 v0.9.9PHP >=7.3 v0.9.20PHP >=7.2 v1.2.0PHP >=7.2 | >=8.0 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/67333?v=4)[webfan](/maintainers/webfan)[@webfan](https://github.com/webfan) --- Top Contributors [![wehowski](https://avatars.githubusercontent.com/u/2658030?v=4)](https://github.com/wehowski "wehowski (343 commits)") --- Tags autoloadingclassmapphp-psr4-autoloaderpsr4autoloadingremotePSR-4 ### Embed Badge ![Health badge](/badges/frdl-remote-psr4/health.svg) ``` [![Health](https://phpackages.com/badges/frdl-remote-psr4/health.svg)](https://phpackages.com/packages/frdl-remote-psr4) ``` ### Alternatives [evilfreelancer/routeros-api-php Modern Mikrotik RouterOS API PHP client for your applications (with Laravel support) 496262.3k6](/packages/evilfreelancer-routeros-api-php)[icamys/php-sitemap-generator Simple PHP sitemap generator. 175364.1k7](/packages/icamys-php-sitemap-generator)[aura/autoload Provides a PSR-4 compliant autoloader implementation. 102515.6k12](/packages/aura-autoload)[genert/bbcode BBCode parser from or to HTML. 81335.4k1](/packages/genert-bbcode)[suin/phpcs-psr4-sniff PHP\_CodeSniffer sniff that checks class name matches PSR-4 project structure. 271.9M19](/packages/suin-phpcs-psr4-sniff)[yidas/codeigniter-psr4-autoload CodeIgniter 3 PSR-4 Autoloader for Application 5520.5k3](/packages/yidas-codeigniter-psr4-autoload) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)