PHP download

Download the PHP package porkbun-php/client without Composer

On this page you can find all versions of the php package porkbun-php/client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download porkbun-php/client
More information about porkbun-php/client
Files in porkbun-php/client

Vendor porkbun-php
Package client
Short Description PHP client for the Porkbun API v3 with domain-centric design, typed DTOs, and complete endpoint coverage
License MIT
Homepage https://github.com/porkbun-php/client

Keywords api dns domain ssl API-Client porkbun domain-registration

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

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 PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

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.

Please rate this library. Is it a good library?

Example code of porkbun-php/client

Informations about the package client

Porkbun PHP API Client

A community-maintained PHP 8.4+ client for the Porkbun API v3 with complete endpoint coverage, domain-centric design, and Laravel integration.

Features

Complete API coverage — all 27 Porkbun API v3 endpoints: DNS, DNSSEC, SSL, nameservers, URL forwarding, glue records, domains, pricing, and more
Domain-centric design — fluent API: $client->domain('example.com')->dns()->all()
Typed everything — immutable DTOs, backed enums, strict return types throughout
Fluent builders — validated DNS record construction with convenience methods
Structured errors — typed exception hierarchy with request/response context
Laravel integration — service provider, facade, and config publishing out of the box
PSR-18 compatible — works with any HTTP client (Guzzle, Symfony, curl, etc.)
Strict quality — Pint, Pest, PHPStan, PHP 8.4+ with Rector

Requirements

PHP 8.4+
A PSR-18 HTTP client (Guzzle, Symfony HttpClient, or any other)

Installation

If you don't already have a PSR-18 HTTP client installed, add one:

[!TIP] Most frameworks already ship with a PSR-18 client — Laravel includes Guzzle, Symfony includes its HttpClient. The package auto-discovers it, so new Porkbun\Client() just works.

Quick Start

Generate your API key and secret on the API Access page. To manage a specific domain via API, enable API Access for that domain in your Porkbun control panel.

Advanced configuration

API Reference

[!NOTE] All endpoints require authentication except Pricing — you can query TLD pricing without API keys.

Pricing (No Auth Required)

Ping (Auth Test)

Domains

Domain Details

Domain Availability

Domain Registration

DNS Records

[!TIP] Use the builder for validated record creation, or direct methods when you need to bypass client-side validation.

DNSSEC Records

Batch DNS Operations

SSL Certificates

Nameservers

URL Forwarding

Glue Records

Auto-Renewal

Error Handling

All exceptions implement Porkbun\Exception\ExceptionInterface for unified catching:

[!TIP] If the default endpoint is unreachable, fall back to $client->useIpv4Endpoint(). See 08-error-handling.php for the full pattern.

Laravel Integration

The package auto-registers via Laravel's package discovery. The service provider is deferred — the client is only instantiated when you use it.

Add credentials to .env:

Optionally publish the config:

Facade

Dependency Injection

Examples

See the examples/ directory for runnable scripts:

01-ping.php - Auth test and IPv4 endpoint switching
02-pricing.php - Public pricing API, cheapest TLDs, iteration
03-domains.php - List domains, pagination, expiring soon, availability check
04-dns.php - DNS CRUD with direct methods, collection helpers
05-dns-builder.php - Fluent builder, convenience methods, immutable templates
06-dns-batch.php - Batch operations, mixed create/edit/delete
07-domain-services.php - Nameservers, URL forwarding, glue records, SSL, auto-renew
08-error-handling.php - Exception hierarchy, endpoint fallback pattern
09-dynamic-dns.php - Real-world dynamic DNS updater recipe
10-multi-account.php - Account switching, public/auth/clearAuth flow
11-laravel.php - Facade usage, dependency injection, Artisan commands

Development

License

MIT License. See LICENSE for details.

All versions of client with dependencies

PHP Build Version

Package Version

Version v1.1.0 Release 15. Mar 2026
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of client from vendor porkbun-php

Requires php Version ^8.4
nyholm/psr7 Version ^1.8
php-http/discovery Version ^1.19
psr/http-client Version ^1.0
psr/http-factory Version ^1.0
psr/http-message Version ^2.0

Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package porkbun-php/client contains the following files

Loading the files please wait ...