PHPackages sudo-ecommerce/image-domain-replace - 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. [Image & Media](/categories/media) 4. / 5. sudo-ecommerce/image-domain-replace ActiveLibrary[Image & Media](/categories/media) sudo-ecommerce/image-domain-replace =================================== Laravel middleware package to replace image domains and handle bucket checks. 4.1.0(4mo ago)0565↓41.7%MITPHPPHP >=7.1 || ^8.0 Since Sep 19Pushed 4mo agoCompare [ Source](https://github.com/Sudo-E-Commerce/Image-Domain-Replace)[ Packagist](https://packagist.org/packages/sudo-ecommerce/image-domain-replace)[ RSS](/packages/sudo-ecommerce-image-domain-replace/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (1)Versions (53)Used By (0) Image Domain Replace Laravel Package ==================================== [](#image-domain-replace-laravel-package) Cài đặt ------- [](#cài-đặt) 1. Thêm vào composer.json của project: ``` "repositories": [ { "type": "path", "url": "./packages/ImageDomainReplace" } ], ``` 2. Cài đặt package: ``` composer require sudo/image-domain-replace:dev-main ``` 3. Publish assets (JavaScript files): ``` php artisan vendor:publish --provider="Sudo\\ImageDomainReplace\\ImageDomainReplaceServiceProvider" --tag=public ``` 4. Publish config (tùy chọn): ``` php artisan vendor:publish --provider="Sudo\\ImageDomainReplace\\ImageDomainReplaceServiceProvider" --tag=config ``` 5. Cấu hình domain mới trong `.env` hoặc `config/image-domain-replace.php`: ``` IMAGE_DOMAIN_REPLACE_NEW=https://storage.sudospaces.com IMAGE_DOMAIN_REPLACE_FALLBACK=/assets/img/default_image.png ``` Cấu hình -------- [](#cấu-hình) File JavaScript sẽ được publish tại: `/vendor/image-domain-replace/js/script.js` Chức năng --------- [](#chức-năng) Package tự động: - Tự động replace domain ảnh cũ về domain mới trong response HTML - Thêm fallback JavaScript cho ảnh lỗi với retry logic thông minh - Tự động kiểm tra/tạo ảnh resize khi cần thiết với API endpoint `/image/check-and-upload` - Xử lý cache busting và retry để tăng độ tin cậy - Hỗ trợ dynamic images (SPA applications) với MutationObserver - Tương thích mọi phiên bản Laravel/PHP >= 7.2 Sử dụng nâng cao ---------------- [](#sử-dụng-nâng-cao) Có thể khởi tạo thủ công JavaScript với config tùy chỉnh: ``` const imageHandler = new ImageDomainReplace({ fallbackImageUrl: '/custom/placeholder.jpg', checkImageUrl: '/image/check-and-upload', maxRetries: 5, retryDelay: 2000, debug: true }); ``` Tuỳ chỉnh --------- [](#tuỳ-chỉnh) - Sửa `config/image-domain-replace.php` để thay đổi domain mới hoặc tắt queue Đóng góp -------- [](#đóng-góp) PR hoặc issue tại repo này. Lưu ý: Tất cả repo sử dụng se mbf cần thêm 'use\_path\_style\_endpoint' => env('AWS\_USE\_PATH\_STYLE\_ENDPOINT', false) ở filesystem.php và AWS\_USE\_PATH\_STYLE\_ENDPOINT=true ở .env IMAGE\_DOMAIN\_REPLACE\_ENABLED=true LICENSE\_MIDDLEWARE\_ENABLED=false STORAGE\_MONITORING\_ENABLED=true là 3 biến để check lần lượt: IMAGE\_DOMAIN\_REPLACE\_ENABLED -> Check replace domain, mặc định true, 1 số dự án ảnh đặt ở local thì để là false. LICENSE\_MIDDLEWARE\_ENABLED -> Check Khoá website STORAGE\_MONITORING\_ENABLED -> Check Khoá dung lượng website ### Health Score 42 — FairBetter than 90% of packages Maintenance76 Regular maintenance activity Popularity16 Limited adoption so far Community10 Small or concentrated contributor base Maturity54 Maturing project, gaining track record Bus Factor1 Top contributor holds 86.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. ### Release Activity Cadence Every ~2 days Total 51 Last Release 131d ago Major Versions v1.1.9 → v2.0.02025-10-06 v2.0.9 → v3.0.02025-11-07 v3.0.9 → v4.0.02025-12-10 PHP version history (2 changes)v1.0.0PHP >=7.1|^8.0 v1.0.2PHP >=7.1 || ^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/d0eb3ba90efb530b8afe7c9b5334f0feaf097dd42ccf19db85cbb4bf3fc7a02d?d=identicon)[tranhaukienit-lang](/maintainers/tranhaukienit-lang) ![](https://www.gravatar.com/avatar/306f2f036d782c875d72a1bcaa028de86e9ce56d432d04d3fd05d8e59e22412c?d=identicon)[Duynguyen0897](/maintainers/Duynguyen0897) --- Top Contributors [![haukientran](https://avatars.githubusercontent.com/u/70125147?v=4)](https://github.com/haukientran "haukientran (63 commits)")[![tranhaukienit-lang](https://avatars.githubusercontent.com/u/232721266?v=4)](https://github.com/tranhaukienit-lang "tranhaukienit-lang (7 commits)")[![Duynguyen0897](https://avatars.githubusercontent.com/u/44739285?v=4)](https://github.com/Duynguyen0897 "Duynguyen0897 (3 commits)") ### Embed Badge ![Health badge](/badges/sudo-ecommerce-image-domain-replace/health.svg) ``` [![Health](https://phpackages.com/badges/sudo-ecommerce-image-domain-replace/health.svg)](https://phpackages.com/packages/sudo-ecommerce-image-domain-replace) ``` ### Alternatives [opentok/opentok OpenTok is a platform for creating real time streaming video applications, created by TokBox. 1413.0M10](/packages/opentok-opentok)[automattic/wistia-php PHP wrapper for Wistia API 1431.9k](/packages/automattic-wistia-php)[daun/statamic-placeholders Generate low-quality image placeholders for lazyloading Statamic assets 106.6k](/packages/daun-statamic-placeholders)[daun/statamic-mux Seamless video encoding and streaming using Mux on Statamic sites 132.3k](/packages/daun-statamic-mux) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)