Download the PHP package imzala/imzala-php without Composer
On this page you can find all versions of the php package imzala/imzala-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download imzala/imzala-php
More information about imzala/imzala-php
Files in imzala/imzala-php
Package imzala-php
Short Description imzala.org server-side SDK — templates, demands, embedded signing, timestamps, webhook verification.
License proprietary
Homepage https://github.com/imzala/imzala-sdk
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package imzala-php
imzala/imzala-php
İmzala dijital imza platformu resmi PHP SDK'sı.
⚠️ Geliştirme aşamasında, yayın öncesi avukat onayı bekliyor. Kapsam ve yayın kararları için monorepo kökündeki RELEASING.md.
Kurulum
PHP 8.1+ gerektirir.
Hızlı başlangıç
baseUrl varsayılan olarak https://api-prd.imzala.org'dur; test ortamı
için new ImzalaClient($apiKey, 'https://test-api.imzala.org'). Otomatik
yeniden deneme (maxRetries, retryBaseDelayMs) aşağıda ayrı bölümde.
Kaynaklar
$imzala->templates()->list($page = null, $limit = null)/->get($id)/->usage($id)/->listAll($page = null, $limit = null)(bkz. aşağıdaki sayfalama notu)$imzala->demands()->create($body)/->get($id)/->addItems($id, $body)/->uploadDocument(new UploadDemandParams($files, $parties))/->sendReminder($id, $body = null)$imzala->embed()->createSession($demandId, $partyId): bkz. aşağıdaki gömülü imza notu$imzala->timestamps()->create(new CreateTimestampParams($content, $fileName))$imzala->me(): API anahtarının sahibi (id, e-posta, workspace, kalan kredi)
create/addItems metodları vendored generated model sınıfı ya da düz
associative array (snake_case anahtarlarla) kabul eder. Dosya yükleyen
metodlar FileInput($content, $fileName, $contentType = null) kullanır;
SDK içeride geçici bir dosyaya yazıp temizler, çağıran taraf dosya
sistemiyle uğraşmaz.
Otomatik yeniden deneme (safe auto-retry)
templates()->list/get/usage, demands()->get ve me() — yani sadece
GET (okuma) uçları — 429 (rate limit, Retry-After'a uyarak) veya 5xx
(sunucu hatası) aldığında, jitter'lı exponential backoff ile otomatik
olarak yeniden denenir:
Güvenlik: demands()->create(), sendReminder(), uploadDocument(),
addItems(), embed()->createSession(), timestamps()->create() gibi
yazma (POST) uçları asla otomatik yeniden denenmez — bu davranış
yapılandırılamaz. Bir demands()->create() çağrısının otomatik tekrarı,
mükerrer bir sözleşme oluşturur; bu yüzden retry mantığı sadece GET
isteklerine bağlıdır (caller tarafından açılıp kapatılabilecek bir bayrak
değildir — bkz. src/Http.php'deki unwrapRetryableGet(), hiçbir yazma
metodu bu fonksiyona yönlendirilmez).
Sayfalama iterator'ı
templates()->list() tek sayfa döner ({templates, total, page, limit}).
Tüm şablonları sayfa sayfa elle çekmek yerine listAll() generator'ını
kullanabilirsiniz — sayfaları şeffaf şekilde gezer:
total alanına ulaşıldığında veya bir sayfa limit'ten az öğe
döndürdüğünde durur — sonsuz döngüye girmez. list() (tek sayfa)
davranışı değişmedi.
Webhook doğrulama
verifyWebhook (statik) asla exception fırlatmaz; geçersiz/eksik imzada
false döner. Body'yi decode edip yeniden encode etmeyin, imza doğrulaması
byte-byte karşılaştırma yapar.
Hata yönetimi
Tüm hatalar ImzalaException'dan türer (getStatusCode(), getBody(),
getErrorCode() ortak); 401/403 → ImzalaAuthException, 429 →
ImzalaRateLimitException (getRetryAfter() saniye), 422 →
ImzalaValidationException.
Not: bu paket, diğer dört dil SDK'sının (Node/Python/.NET/Java)
ImzalaError/ImzalaError-türevi isimlendirmesinden farklı olarak PHP konvansiyonuna uyupImzalaException/Imzala*Exceptionisimlerini kullanır; davranış (4'lü taksonomi, aynı alanlar) aynıdır.
⚠️ Sunucu-taraflı
Bu paket sadece sunucuda kullanılır. API anahtarınızı tarayıcı
JavaScript'ine veya mobil uygulamaya asla gömmeyin: sızarsa hesabınızdaki
tüm sözleşme/şablon/zaman damgası işlemlerine erişim kazanılır. Tarayıcıda
imza almak için @imzala/embed veya
@imzala/embed-react kullanın.
İmza sınıfı notu
İmzala dijital imza (SES) üretir; her imza zaman damgalıdır. Nitelikli/ güvenli elektronik imza (QES) DEĞİLDİR.
$imzala->embed()->createSession(...) şu an yalnızca test ortamında
çalışır; gömülü imza özelliği henüz avukat onaylı prod-canlı değildir.
Kapsam kararı RELEASING.md'de.
Daha fazla
- Monorepo README: tüm paketler + genel desen
- RELEASING.md: sürüm yayınlama, kapsam kararları
