PHPackages jinomial/laravel-ssl - 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. [Utility & Helpers](/categories/utility) 4. / 5. jinomial/laravel-ssl ActiveLibrary[Utility & Helpers](/categories/utility) jinomial/laravel-ssl ==================== An SSL service for Laravel v3.0.0(2mo ago)2191MITPHPPHP ^8.3CI passing Since Oct 31Pushed 2mo ago1 watchersCompare [ Source](https://github.com/jinomial/laravel-ssl)[ Packagist](https://packagist.org/packages/jinomial/laravel-ssl)[ Docs](https://github.com/jinomial/laravel-ssl)[ RSS](/packages/jinomial-laravel-ssl/feed)WikiDiscussions master Synced today READMEChangelog (4)Dependencies (12)Versions (5)Used By (0) Laravel SSL =========== [](#laravel-ssl) An SSL/TLS service and facade for Laravel. Capture peer certificates using 'openssl' or 'stream' drivers, or create your own driver. DriverDescriptionopensslExecutes the *openssl* commandstreamPHP's `stream_*()` functionsfileParses local certificate filesInstallation ------------ [](#installation) Install the package via composer: ``` composer require jinomial/laravel-ssl ``` The default configuration is to use the *openssl* driver. ``` 'openssl' => [ 'driver' => 'openssl', ], ``` Publish the config file to change the default driver: ``` php artisan vendor:publish --provider="Jinomial\LaravelSsl\SslServiceProvider" --tag="laravel-ssl-config" ``` Usage ----- [](#usage) Capture the certificate of *jinomial.com:443* using the default driver: ``` use Jinomial\LaravelSsl\Facades\Ssl; // Returns a CertificateCollection $certificates = Ssl::show('google.com'); $cert = $certificates->first(); echo $cert->getCommonName(); // "google.com" echo $cert->isValid() ? 'Valid' : 'Expired/Invalid'; echo $cert->getValidTo()->diffForHumans(); // "in 3 months" ``` ### Certificate Helper Methods [](#certificate-helper-methods) The `Certificate` DTO provides several helpful methods: MethodDescription`isValid()`Returns true if the cert is not expired and verification passed`isExpired()`Returns true if the current time is past the `validTo` date`getCommonName()`Get the Common Name (CN) from the subject`getIssuerCommonName()`Get the Common Name (CN) from the issuer`getValidFrom()`Returns a `Carbon` instance for the start date`getValidTo()`Returns a `Carbon` instance for the expiration date`getSubjectAlternativeNames()`Returns an array of SANs`getHost()` / `getPort()`The connection details used for this certificate### Advanced Usage [](#advanced-usage) Multiple lookups at once: ``` $results = Ssl::show([ ['host' => 'google.com', 'port' => '443'], ['host' => 'github.com', 'port' => '443'], ]); // Find a specific result $githubCert = $results->where('host', 'github.com')->first(); ``` Use a specific driver: ``` $response = Ssl::driver('stream')->show('google.com', '443', [ // Get the certificate only without the CA Chain. \Jinomial\LaravelSsl\Drivers\Stream::OPTION_CHAIN => false, ]); ``` The *openssl* driver executes the *openssl* binary (must be in your $PATH) to retrieve the X509 certificate. Each response is indexed. `certificate` is the return value from [`openssl_x509_parse()`](https://www.php.net/manual/function.openssl-x509-parse.php). `verification` contains the verification code and verification message. ``` Array ( [0] => Array ( [certificate] => Array ( [name] => /C=US/ST=California/L=San Francisco/O=Cloudflare, Inc./CN=sni.cloudflaressl.com [subject] => Array ( [C] => US [ST] => California [L] => San Francisco [O] => Cloudflare, Inc. [CN] => sni.cloudflaressl.com ) [hash] => c959965e [issuer] => Array ( [C] => US [O] => Cloudflare, Inc. [CN] => Cloudflare Inc ECC CA-3 ) [version] => 2 [serialNumber] => 7490133585878873344260773043003356172 [serialNumberHex] => 05A28C18F8F74ACBCCF6A4542736740C [validFrom] => 211004000000Z [validTo] => 221003235959Z [validFrom_time_t] => 1633305600 [validTo_time_t] => 1664841599 [signatureTypeSN] => ecdsa-with-SHA256 [signatureTypeLN] => ecdsa-with-SHA256 [signatureTypeNID] => 794 [purposes] => Array ( [1] => Array ( [0] => 1 [1] => [2] => sslclient ) [2] => Array ( [0] => 1 [1] => [2] => sslserver ) [3] => Array ( [0] => [1] => [2] => nssslserver ) [4] => Array ( [0] => [1] => [2] => smimesign ) [5] => Array ( [0] => [1] => [2] => smimeencrypt ) [6] => Array ( [0] => [1] => [2] => crlsign ) [7] => Array ( [0] => 1 [1] => 1 [2] => any ) [8] => Array ( [0] => 1 [1] => [2] => ocsphelper ) [9] => Array ( [0] => [1] => [2] => timestampsign ) ) [extensions] => Array ( [authorityKeyIdentifier] => keyid:A5:CE:37:EA:EB:B0:75:0E:94:67:88:B4:45:FA:D9:24:10:87:96:1F [subjectKeyIdentifier] => 1B:20:D1:CD:00:32:24:77:9F:F8:22:94:0F:B6:48:7F:39:B1:BE:C8 [subjectAltName] => DNS:*.jinomial.com, DNS:sni.cloudflaressl.com, DNS:jinomial.com [keyUsage] => Digital Signature [extendedKeyUsage] => TLS Web Server Authentication, TLS Web Client Authentication [crlDistributionPoints] => Full Name: URI:http://crl3.digicert.com/CloudflareIncECCCA-3.crl Full Name: URI:http://crl4.digicert.com/CloudflareIncECCCA-3.crl [certificatePolicies] => Policy: 2.23.140.1.2.2 CPS: http://www.digicert.com/CPS [authorityInfoAccess] => OCSP - URI:http://ocsp.digicert.com CA Issuers - URI:http://cacerts.digicert.com/CloudflareIncECCCA-3.crt [basicConstraints] => CA:FALSE [ct_precert_scts] => Signed Certificate Timestamp: Version : v1 (0x0) Log ID : 46:A5:55:EB:75:FA:91:20:30:B5:A2:89:69:F4:F3:7D: 11:2C:41:74:BE:FD:49:B8:85:AB:F2:FC:70:FE:6D:47 Timestamp : Oct 4 22:14:44.288 2021 GMT Extensions: none Signature : ecdsa-with-SHA256 30:45:02:20:48:67:EF:28:F6:F2:B7:C8:F5:0D:7C:3D: 21:7B:D3:C9:37:4E:B2:7C:AC:70:22:9D:7F:4C:75:D1: 27:97:89:9C:02:21:00:D9:44:6B:10:0B:F0:6E:2D:99: 79:77:D7:C8:91:51:C5:E9:50:92:13:EE:99:80:50:FF: CB:BD:E6:87:5F:47:A6 Signed Certificate Timestamp: Version : v1 (0x0) Log ID : 51:A3:B0:F5:FD:01:79:9C:56:6D:B8:37:78:8F:0C:A4: 7A:CC:1B:27:CB:F7:9E:88:42:9A:0D:FE:D4:8B:05:E5 Timestamp : Oct 4 22:14:44.292 2021 GMT Extensions: none Signature : ecdsa-with-SHA256 30:44:02:20:02:92:85:B2:A1:C6:09:18:E5:F4:48:12: 32:C9:D6:FF:AE:F8:85:DC:E0:06:0D:CB:86:62:5C:E1: 24:6B:F3:7D:02:20:03:20:01:0B:91:19:AD:4A:87:18: FA:5F:A3:98:13:95:CD:EC:8E:1D:63:22:EB:6A:E2:FE: 33:BC:B1:D8:6C:6B Signed Certificate Timestamp: Version : v1 (0x0) Log ID : 41:C8:CA:B1:DF:22:46:4A:10:C6:A1:3A:09:42:87:5E: 4E:31:8B:1B:03:EB:EB:4B:C7:68:F0:90:62:96:06:F6 Timestamp : Oct 4 22:14:44.184 2021 GMT Extensions: none Signature : ecdsa-with-SHA256 30:46:02:21:00:C3:35:6C:A6:27:01:94:88:CF:85:C6: 3D:33:06:08:DE:BB:14:61:D4:34:8C:AD:A4:24:1B:0F: FB:A7:17:13:EA:02:21:00:AE:AB:D7:C2:22:B6:FA:FE: 7E:20:DA:94:44:18:41:91:DB:98:AC:EA:F8:03:36:57: D5:7C:33:4B:71:03:05:9B ) ) [verification] => Array ( [code] => 0 [message] => ok ) ) ) ``` ### Local File Driver [](#local-file-driver) You can also parse local certificate files using the `file` driver. This is useful for checking certificates stored on disk. ``` use Jinomial\LaravelSsl\Facades\Ssl; // Provide a path to a certificate file $certificates = Ssl::driver('file')->show('/path/to/certificate.crt'); ``` The **id-ad-caIssuers** property can be followed to get the issuer certificate: ``` $response = Ssl::show( 'http://cacerts.digicert.com/CloudflareIncECCCA-3.crt', 443, ['id-ad-caIssuers' => true] ); ``` ### stream driver responses [](#stream-driver-responses) The *stream* driver uses PHP's `stream_*` functions and SSL context to capture entire peer certificate chains. Each response is indexed. The subindex is the chain sequence with 0 being the host, 1 being the issuer (if not self signed), etc. Results are the return value from [`openssl_x509_parse()`](https://www.php.net/manual/function.openssl-x509-parse.php). Artisan Commands ---------------- [](#artisan-commands) ### Show Certificate [](#show-certificate) Show details for a specific host: ``` php artisan ssl:show google.com ``` ### Bulk SSL Check [](#bulk-ssl-check) Monitor multiple hosts at once. This command can check hosts provided as arguments or those configured in `config/ssl.php`. ``` # Check specific hosts php artisan ssl:check google.com github.com # Check all hosts configured in ssl.monitored_hosts php artisan ssl:check ``` The command will output a table showing the status, common name, and expiration time for each host. Custom Drivers -------------- [](#custom-drivers) Create a class that extends `Jinomial\LaravelSsl\Drivers\Driver`. Implement `public function show()` according to the `Jinomial\LaravelSsl\Contracts\Ssl\Driver` contract. Register a driver factory with the `Jinomial\LaravelSsl\SslManager`. ``` /** * Application service provider bootstrap for package services. * * \App\Ssl\Drivers\SslCapture is my custom driver class I made. * The SslManager needs to know how to construct it. */ public function boot(): void { $sslLoader = $this->app->get(\Jinomial\LaravelSsl\SslManager::class); $driverName = 'my-custom-driver'; $sslLoader->extend($driverName, function () use ($driverName) { return new \App\Ssl\Drivers\SslCapture($driverName); }); } ``` Testing ------- [](#testing) Run all tests: ``` composer test ``` Test suites are separated into "unit" and "integration". Run each suite: ``` composer test:unit composer test:integration ``` Tests are grouped into the following groups: - network - drivers - openssl - manager - facades - commands Run tests for groups: ``` composer test -- --include=manager,facades ``` Network tests make remote calls that can take time or fail. Exclude them: ``` composer test:unit -- --exclude=network ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](.github/SECURITY.md) on how to report security vulnerabilities. Credits ------- [](#credits) - [Jason Schmedes](https://github.com/jinomial) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 46 — FairBetter than 92% of packages Maintenance83 Actively maintained with recent releases Popularity10 Limited adoption so far Community10 Small or concentrated contributor base Maturity68 Established project with proven stability Bus Factor1 Top contributor holds 88.9% 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 ~540 days Total 4 Last Release 85d ago Major Versions v1.0.0-beta.1 → v2.0.02025-01-02 v2.1.0 → v3.0.02026-04-09 PHP version history (3 changes)v1.0.0-beta.1PHP ^8.0 v2.0.0PHP 8.2 - 8.4 v3.0.0PHP ^8.3 ### Community Maintainers ![](https://www.gravatar.com/avatar/26f680a2a0545691ca0b1e8268798ef37d6ab3f0942289914d7a58f49efddf99?d=identicon)[jinomial](/maintainers/jinomial) --- Top Contributors [![jinomial](https://avatars.githubusercontent.com/u/91918643?v=4)](https://github.com/jinomial "jinomial (8 commits)")[![XternalSoft](https://avatars.githubusercontent.com/u/1142472?v=4)](https://github.com/XternalSoft "XternalSoft (1 commits)") --- Tags laraveltlsssllaravel-ssljinomial ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/jinomial-laravel-ssl/health.svg) ``` [![Health](https://phpackages.com/badges/jinomial-laravel-ssl/health.svg)](https://phpackages.com/packages/jinomial-laravel-ssl) ``` ### Alternatives [laravel/socialite Laravel wrapper around OAuth 1 & OAuth 2 libraries. 5.7k108.5M885](/packages/laravel-socialite)[nativephp/mobile NativePHP for Mobile 1.1k75.1k91](/packages/nativephp-mobile)[psalm/plugin-laravel Psalm plugin for Laravel 3355.3M346](/packages/psalm-plugin-laravel)[spatie/laravel-export Create a static site bundle from a Laravel app 674146.0k6](/packages/spatie-laravel-export)[spatie/laravel-health Monitor the health of a Laravel application 87512.0M165](/packages/spatie-laravel-health)[maestroerror/laragent Power of AI Agents in your Laravel project 639159.9k](/packages/maestroerror-laragent) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)