Download the PHP package aicrion/ir-currency-rate-scraper without Composer
On this page you can find all versions of the php package aicrion/ir-currency-rate-scraper. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Please rate this library. Is it a good library?
Informations about the package ir-currency-rate-scraper
Iranian Currency, Gold, Coin & Crypto Rate Scraper (PHP 7.4+)
A modern, resilient, and extensible PHP 7.4+ library for scraping and aggregating real-time exchange rates, gold prices, coins, and cryptocurrencies from multiple Iranian and global financial sources (TGJU, ArzDigital, etc.).
🚀 Features
- Strict PHP 7.4+ Compatibility: Works seamlessly across PHP 7.4, 8.0, 8.1, 8.2, 8.3, and 8.4 with
declare(strict_types=1);. - ⚡ High-Performance Caching & Warmup:
- Built-in drivers:
FileCache(persistent on disk with TTL and file locking) andArrayCache(in-memory). Psr16CacheAdapterfor plugging in Redis, Memcached, Laravel, or Symfony Cache.warmup()method: Preloads, refreshes, and caches all market rates upfront so subsequent calls are served with 0ms network latency.
- Built-in drivers:
- 💱 Real-Time Currency Converter & Gold Calculator:
- Live conversions:
USD <-> IRR,USD <-> TOMAN,EUR <-> AED,BTC <-> TOMAN. - Gold jewelry breakdown: calculates raw gold base value, craftsmanship wage, seller profit, and VAT tax.
- Live conversions:
- 🔔 Price Alerts & Fluctuation Watcher:
- Register target price and 24h percentage fluctuation alerts with custom callbacks (SMS, Telegram, Webhooks).
- 💻 Standalone CLI Tool:
- Executable command at
bin/currencyfor retrieving rates, converting, and cache warming in terminal.
- Executable command at
- 🛡️ Proxy & User-Agent Rotation:
- Built-in HTTP proxy authentication and rotating User-Agent pools for heavy-duty scraping.
- Multi-Source Aggregation Engine:
- Fallback / First Available: Query primary source; seamlessly fall back to secondary sources or profile pages if unavailable.
- Average Calculation: Automatically query multiple sources (e.g. TGJU + ArzDigital for crypto) and calculate average, minimum, and maximum prices.
- Resilient Multi-Layer Scraping:
- Semantic table header scanning, data attribute matchers (
data-market-row,data-price), and dedicated profile fallbacks (e.g./profile/price_dollar_rl,/profile/geram18,/profile/geram24).
- Semantic table header scanning, data attribute matchers (
- Comprehensive Market Coverage:
- 💵 Free Market, 🏛️ Central Bank, 🏦 SANA, 📑 NIMA, 🔄 Remittance, 🥇 Gold, 🪙 Coins, ⚡ Crypto Top 100.
- Global Search Capability: Search by Persian title (e.g.
دلار,طلای ۱۸ عیار,سکه امامی) or international symbol (USD,BTC,EUR).
📦 Installation
💡 Quick Start
💻 CLI Commands
🧪 Testing & Quality Assurance
📄 License
This library is open-sourced software licensed under the MIT license.
All versions of ir-currency-rate-scraper with dependencies
PHP Build Version
Package Version
Requires
php Version
>=7.4
ext-json Version *
ext-curl Version *
ext-mbstring Version *
symfony/dom-crawler Version ^5.4 || ^6.4 || ^7.0
symfony/css-selector Version ^5.4 || ^6.4 || ^7.0
ext-json Version *
ext-curl Version *
ext-mbstring Version *
symfony/dom-crawler Version ^5.4 || ^6.4 || ^7.0
symfony/css-selector Version ^5.4 || ^6.4 || ^7.0
The package aicrion/ir-currency-rate-scraper contains the following files
Loading the files please wait ...