PHPackages mohamedhabibwork/laravel-oci-driver - 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. [Database & ORM](/categories/database) 4. / 5. mohamedhabibwork/laravel-oci-driver ActiveLibrary[Database & ORM](/categories/database) mohamedhabibwork/laravel-oci-driver =================================== This is my package laravel-oci-driver 1790↓100%[1 PRs](https://github.com/mohamedhabibwork/laravel-oci-driver/pulls)PHPCI failing Since Jul 5Pushed 8mo agoCompare [ Source](https://github.com/mohamedhabibwork/laravel-oci-driver)[ Packagist](https://packagist.org/packages/mohamedhabibwork/laravel-oci-driver)[ RSS](/packages/mohamedhabibwork-laravel-oci-driver/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (2)Used By (0) Laravel OCI Driver ================== [](#laravel-oci-driver) [![Laravel OCI Driver](https://camo.githubusercontent.com/87b3f3194af8066e595c0b2120d97e2163b9757bd478510718f1371bd9ea4e59/68747470733a2f2f706c616365686f6c642e636f2f393030783132302f3232323233612f6666666666663f746578743d4c61726176656c2b4f43492b4472697665722b2537432b4f43492b4c61726176656c2b46696c6573797374656d2b2537432b46756c6c2b446f6373)](https://camo.githubusercontent.com/87b3f3194af8066e595c0b2120d97e2163b9757bd478510718f1371bd9ea4e59/68747470733a2f2f706c616365686f6c642e636f2f393030783132302f3232323233612f6666666666663f746578743d4c61726176656c2b4f43492b4472697665722b2537432b4f43492b4c61726176656c2b46696c6573797374656d2b2537432b46756c6c2b446f6373) [![Latest Version on Packagist](https://camo.githubusercontent.com/b4cf88e09c3f1169cb26189879be5f22c1740fe35990aad896eb6f759b5408d0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d6f68616d65646861626962776f726b2f6c61726176656c2d6f63692d6472697665722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mohamedhabibwork/laravel-oci-driver)[![GitHub Tests Action Status](https://camo.githubusercontent.com/1b6d7fb4b45952bc458d77aeac5d55f5ab7afe4895de312788dff2817a4d7df0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6d6f68616d65646861626962776f726b2f6c61726176656c2d6f63692d6472697665722f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/mohamedhabibwork/laravel-oci-driver/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/81f7577651acf1e882a83ff26af257b4f21bfc068e2b9d1003353666cbd4dbd2/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6d6f68616d65646861626962776f726b2f6c61726176656c2d6f63692d6472697665722f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/mohamedhabibwork/laravel-oci-driver/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/2abfe762cabde87aba22244cb67fda5a91717c26f573e019893d051a382828e1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d6f68616d65646861626962776f726b2f6c61726176656c2d6f63692d6472697665722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mohamedhabibwork/laravel-oci-driver)[![PHPStan Level](https://camo.githubusercontent.com/fff00cebb924e124a7335e6bd8ca8f8cf38869463c1654eff45d0939f1f21c57/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c253230382d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](https://phpstan.org/) --- πŸ› οΈ How to Install ----------------- [](#️-how-to-install) ``` composer require mohamedhabibwork/laravel-oci-driver ``` --- πŸš€ Implemented Features ---------------------- [](#-implemented-features) - **Artisan Commands:** - `oci:setup` – Create Oracle-compatible `.oci` folder, generate/copy key files, write config - `oci:config` – Interactive configuration for OCI settings, with `--validate` to check config - `oci:connection` – Manage multiple OCI connections: `list`, `test`, `switch`, `summary` - `oci:status` – Check connection status, test file operations, and list files in a bucket - **Key Providers:** - File-based (from file path) - Environment-based (from env variable, supports base64) - Custom providers via interface - **Enums:** - `ConnectionType` (primary, secondary, backup, development, testing, staging, production, archive) - `StorageTier` (Standard, InfrequentAccess, Archive) - `LogLevel` (emergency, alert, critical, error, warning, notice, info, debug) - **Exception Handling:** - `PrivateKeyFileNotFoundException` - `SignerValidateException` - `SigningValidationFailedException` - **Configuration:** - All required OCI config: tenancy, user, fingerprint, key path, region, namespace, bucket, storage tier - Optional: prefix, url, passphrase, advanced performance/cache options, debug/logging - **Integration:** - Laravel filesystem disk driver (`oci`) - Event system for file operations (upload, download, delete, etc.) - Service provider auto-registers everything - Health check and connection validation built-in --- ⚑ Quick Start ------------- [](#-quick-start) ``` use Illuminate\Support\Facades\Storage; // Upload a file Storage::disk('oci')->put('documents/hello.txt', 'Hello, Oracle Cloud!'); // Download a file $content = Storage::disk('oci')->get('documents/hello.txt'); // List files $files = Storage::disk('oci')->files('documents'); ``` --- πŸ“š Documentation --------------- [](#-documentation) - [Configuration Guide](docs/CONFIGURATION.md) β€” All config options, environment variables, and best practices - [Authentication Setup](docs/AUTHENTICATION.md) β€” Key management, provider types, and security notes - [Usage Examples](docs/EXAMPLES.md) β€” Real-world code snippets for common tasks - [Testing Guide](docs/TESTING.md) β€” How to test, recommended tools, and sample tests - [Performance Guide](docs/PERFORMANCE.md) β€” Tuning, caching, and large file strategies - [Security Guide](docs/SECURITY.md) β€” Best practices, secrets management, and compliance - [Advanced Features](docs/ADVANCED.md) β€” Bulk ops, events, custom providers, and more - [Migration Guide](docs/MIGRATION.md) β€” Migrate from S3, GCS, or local storage - [Deployment Guide](docs/DEPLOYMENT.md) β€” Production deployment strategies - [Troubleshooting Guide](docs/TROUBLESHOOTING.md) β€” Common issues and solutions - [API Reference](docs/API_REFERENCE.md) β€” Full method signatures and options --- πŸ“ API Reference --------------- [](#-api-reference) See the [API\_REFERENCE.md](docs/API_REFERENCE.md) for full method signatures, options, and advanced usage. For configuration, authentication, and advanced features, see the relevant guides above. --- πŸ§ͺ Testing --------- [](#-testing) ``` composer test ``` See the [Testing Guide](docs/TESTING.md) for more details and examples. --- πŸ”§ Troubleshooting ----------------- [](#-troubleshooting) - Use `php artisan oci:config --validate` to check your configuration - Ensure your OCI credentials and key files are correct - Check file permissions for private keys - See [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) for more help --- 🀝 Contributing -------------- [](#-contributing) See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. --- πŸ“ž Support --------- [](#-support) - [GitHub Issues](https://github.com/mohamedhabibwork/laravel-oci-driver/issues) - [GitHub Discussions](https://github.com/mohamedhabibwork/laravel-oci-driver/discussions) - Email: --- πŸ“„ License --------- [](#-license) The MIT License (MIT). See [LICENSE.md](LICENSE.md) for details. --- πŸ—ΊοΈ Roadmap ---------- [](#️-roadmap) - Advanced Health Checks (Spatie Health integration) - Connection Pooling and advanced parallel/multipart upload support - Custom Event Listeners for all storage operations - Improved Error Reporting and user-friendly CLI output - Web UI for Connection Management - More Key Providers (e.g., HashiCorp Vault, AWS Secrets Manager) - Automatic Key Rotation - Enhanced Documentation & Examples - Support for Additional OCI Services (beyond Object Storage) - Performance Benchmarks and Tuning Guides --- πŸ‘₯ Credits --------- [](#-credits) - **[Mohamed Habib](https://github.com/mohamedhabibwork)** - Creator & Lead Developer - [All Contributors](../../contributors) --- **Made with ❀️ for the Laravel community** [⭐ Star us on GitHub](https://github.com/mohamedhabibwork/laravel-oci-driver) | [πŸ“š Documentation](https://github.com/mohamedhabibwork/laravel-oci-driver/blob/main/README.md) | [πŸ› Report Bug](https://github.com/mohamedhabibwork/laravel-oci-driver/issues) | [πŸ’‘ Request Feature](https://github.com/mohamedhabibwork/laravel-oci-driver/discussions) ### Health Score 23 β€” LowBetter than 27% of packages Maintenance42 Moderate activity, may be stable Popularity16 Limited adoption so far Community19 Small or concentrated contributor base Maturity16 Early-stage or recently created project Bus Factor1 Top contributor holds 58.3% 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/465ce474e9c105751d2df13e0aa0f243cdd37909529b7f957cac01251644b1b1?d=identicon)[mohamedhabibwork](/maintainers/mohamedhabibwork) --- Top Contributors [![freekmurze](https://avatars.githubusercontent.com/u/483853?v=4)](https://github.com/freekmurze "freekmurze (368 commits)")[![mvdnbrk](https://avatars.githubusercontent.com/u/802681?v=4)](https://github.com/mvdnbrk "mvdnbrk (46 commits)")[![mohamedhabibwork](https://avatars.githubusercontent.com/u/64292519?v=4)](https://github.com/mohamedhabibwork "mohamedhabibwork (28 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (24 commits)")[![Nielsvanpach](https://avatars.githubusercontent.com/u/10651054?v=4)](https://github.com/Nielsvanpach "Nielsvanpach (23 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (18 commits)")[![pforret](https://avatars.githubusercontent.com/u/474312?v=4)](https://github.com/pforret "pforret (16 commits)")[![sebastiandedeyne](https://avatars.githubusercontent.com/u/1561079?v=4)](https://github.com/sebastiandedeyne "sebastiandedeyne (14 commits)")[![patinthehat](https://avatars.githubusercontent.com/u/5508707?v=4)](https://github.com/patinthehat "patinthehat (10 commits)")[![riasvdv](https://avatars.githubusercontent.com/u/3626559?v=4)](https://github.com/riasvdv "riasvdv (10 commits)")[![AdrianMrn](https://avatars.githubusercontent.com/u/12762044?v=4)](https://github.com/AdrianMrn "AdrianMrn (8 commits)")[![crynobone](https://avatars.githubusercontent.com/u/172966?v=4)](https://github.com/crynobone "crynobone (8 commits)")[![AlexVanderbist](https://avatars.githubusercontent.com/u/6287961?v=4)](https://github.com/AlexVanderbist "AlexVanderbist (7 commits)")[![irfanm96](https://avatars.githubusercontent.com/u/42065936?v=4)](https://github.com/irfanm96 "irfanm96 (5 commits)")[![thecaliskan](https://avatars.githubusercontent.com/u/13554944?v=4)](https://github.com/thecaliskan "thecaliskan (5 commits)")[![IGedeon](https://avatars.githubusercontent.com/u/694313?v=4)](https://github.com/IGedeon "IGedeon (4 commits)")[![abenerd](https://avatars.githubusercontent.com/u/7523903?v=4)](https://github.com/abenerd "abenerd (3 commits)")[![jessarcher](https://avatars.githubusercontent.com/u/4977161?v=4)](https://github.com/jessarcher "jessarcher (3 commits)")[![koossaayy](https://avatars.githubusercontent.com/u/6431084?v=4)](https://github.com/koossaayy "koossaayy (3 commits)")[![lloricode](https://avatars.githubusercontent.com/u/8251344?v=4)](https://github.com/lloricode "lloricode (3 commits)") ### Embed Badge ![Health badge](/badges/mohamedhabibwork-laravel-oci-driver/health.svg) ``` [![Health](https://phpackages.com/badges/mohamedhabibwork-laravel-oci-driver/health.svg)](https://phpackages.com/packages/mohamedhabibwork-laravel-oci-driver) ``` ### Alternatives [doctrine/orm Object-Relational-Mapper for PHP 10.2k285.3M6.2k](/packages/doctrine-orm)[jdorn/sql-formatter a PHP SQL highlighting library 3.9k115.1M102](/packages/jdorn-sql-formatter)[illuminate/database The Illuminate Database package. 2.8k52.4M9.4k](/packages/illuminate-database)[mongodb/mongodb MongoDB driver library 1.6k64.0M546](/packages/mongodb-mongodb)[ramsey/uuid-doctrine Use ramsey/uuid as a Doctrine field type. 90340.3M211](/packages/ramsey-uuid-doctrine)[reliese/laravel Reliese Components for Laravel Framework code generation. 1.7k3.4M16](/packages/reliese-laravel) PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)