PHPackages                             blackcart/lob-php - 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. [HTTP &amp; Networking](/categories/http)
4. /
5. blackcart/lob-php

ActiveLibrary[HTTP &amp; Networking](/categories/http)

blackcart/lob-php
=================

3.5.6 fork of lob/lob-php to include International Autocompletions

4.1.0(3y ago)06.3kunlicensePHPPHP ^7.3 || ^8.0

Since Jul 23Pushed 3y agoCompare

[ Source](https://github.com/blackcart/lob-php)[ Packagist](https://packagist.org/packages/blackcart/lob-php)[ Docs](https://openapi-generator.tech)[ RSS](/packages/blackcart-lob-php/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (5)Versions (64)Used By (0)

lob-php
=======

[](#lob-php)

[![PHP version](https://camo.githubusercontent.com/13bf84965cf3b733ea0344bf77b11554c3275efc5b3a314dc94475c76e435c7b/68747470733a2f2f62616467652e667572792e696f2f70682f6c6f622532466c6f622d7068702e737667)](https://badge.fury.io/ph/lob%2Flob-php)[![Build Status](https://camo.githubusercontent.com/9c94e30258da4b22af1791b7900acff1ddba685128b89660b6c11e44a0255fa2/68747470733a2f2f7472617669732d63692e6f72672f6c6f622f6c6f622d7068702e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/lob/lob-php)[![Coverage Status](https://camo.githubusercontent.com/d672cdb9c1e5b11462128b8cf275a1ea4f435d078ab385da236e98cae205a146/68747470733a2f2f696d672e736869656c64732e696f2f636f766572616c6c732f6c6f622f6c6f622d7068702e737667)](https://coveralls.io/r/lob/lob-php?branch=master)

Lob.com PHP Client is a simple but flexible wrapper for the [Lob.com](https://www.lob.com) API. See full Lob.com documentation [here](https://lob.com/docs/php). For best results, be sure that you're using [the latest version](https://lob.com/docs/php#version) of the Lob API and the latest version of the PHP wrapper.

Table of Contents
-----------------

[](#table-of-contents)

- [Table of Contents](#table-of-contents)
- [Getting Started](#getting-started)
    - [Registration](#registration)
    - [Installation](#installation)
    - [Usage](#usage)
- [Examples](#examples)
- [Testing](#testing)

Getting Started
---------------

[](#getting-started)

Here's a general overview of the Lob services available, click through to read more.

- [Postcards API](https://lob.com/products/print-mail/postcards)
- [Letters API](https://lob.com/products/print-mail/letters)
- [Checks API](https://lob.com/products/print-mail/checks)
- [Address Verification API](https://lob.com/products/address-verification)

Please read through the official [API Documentation](https://docs.lob.com/) to get a complete sense of what to expect from each endpoint.

### Registration

[](#registration)

First, you will need to first create an account at [Lob.com](https://dashboard.lob.com/#/register) and obtain your Test and Live API Keys.

Once you have created an account, you can access your API Keys from the [Settings Panel](https://dashboard.lob.com/#/settings).

### Installation

[](#installation)

The recommended way to install Lob.com PHP Client is through [Composer](https://getcomposer.org).

```
// Install Composer
curl -sS https://getcomposer.org/installer | php

// Add Lob.com PHP client as a dependency
php composer.phar require lob/lob-php
```

// Add all dependencies necessary to run php composer.phar install

```

After installing, you need to require Composer's autoloader in your files:

```php
require 'vendor/autoload.php';

```

### Usage

[](#usage)

```
// Provide an API Key in the class constructor
// in order to instantiate the Lob object
$apiKey = 'API Key here';
$lob = new \Lob\Lob($apiKey);
```

Examples
--------

[](#examples)

We've provided various examples for you to try out [here](https://github.com/lob/lob-php/tree/master/examples).

There are simple scripts to demonstrate how to create all the core Lob objects (checks, letters, postcards. etc.) as well as more complex examples that utilize other libraries and external files.

Testing
-------

[](#testing)

Lob.com PHP Client uses PHPUnit for unit testing.

In order to run the unit tests, you'll first need to install the dependencies using Composer.

```
composer install --dev # For PHP 5.6
composer install       # For PHP >= 7.0

```

Once the dependencies have been installed, the tests can be run with

```
LOB_API_KEY= php vendor/bin/phpunit

```

To get a code coverage report after running the test suite, run

```
php vendor/bin/coveralls -v

```

=======================

Copyright © 2018 Lob.com

Released under the MIT License, which can be found in the repository in `LICENSE.txt`.

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity82

Battle-tested with a long release history

 Bus Factor4

4 contributors hold 50%+ of commits

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 ~58 days

Recently: every ~19 days

Total

57

Last Release

1450d ago

Major Versions

v1.7.1 → v2.0.02017-05-17

v2.3.0 → v3.0.02018-07-02

v3.5.5 → 4.0.0-rc-32022-05-31

v3.5.6 → 4.1.02022-07-13

PHP version history (4 changes)v1.0.0PHP &gt;=5.3.0

v2.1.2PHP &gt;=5.6.0

v3.5.2PHP &gt;=7.4.0

4.0.0-rc-3PHP ^7.3 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/2e0fc5dbfc7a4f7cb12ac0783f104aa1b4649b3b98c2030f688eb1f7d1fc161f?d=identicon)[cguru90](/maintainers/cguru90)

---

Top Contributors

[![pon](https://avatars.githubusercontent.com/u/689556?v=4)](https://github.com/pon "pon (47 commits)")[![daniloassis](https://avatars.githubusercontent.com/u/423715?v=4)](https://github.com/daniloassis "daniloassis (20 commits)")[![joshstrange](https://avatars.githubusercontent.com/u/462796?v=4)](https://github.com/joshstrange "joshstrange (17 commits)")[![mgartner](https://avatars.githubusercontent.com/u/1128750?v=4)](https://github.com/mgartner "mgartner (15 commits)")[![mwj8410](https://avatars.githubusercontent.com/u/6383741?v=4)](https://github.com/mwj8410 "mwj8410 (11 commits)")[![leore](https://avatars.githubusercontent.com/u/1742451?v=4)](https://github.com/leore "leore (7 commits)")[![mpiercy827](https://avatars.githubusercontent.com/u/10817843?v=4)](https://github.com/mpiercy827 "mpiercy827 (7 commits)")[![shrav](https://avatars.githubusercontent.com/u/1908153?v=4)](https://github.com/shrav "shrav (6 commits)")[![ami](https://avatars.githubusercontent.com/u/5498072?v=4)](https://github.com/ami "ami (6 commits)")[![dmlittle](https://avatars.githubusercontent.com/u/3803621?v=4)](https://github.com/dmlittle "dmlittle (5 commits)")[![amrit](https://avatars.githubusercontent.com/u/1221404?v=4)](https://github.com/amrit "amrit (5 commits)")[![robinjoseph08](https://avatars.githubusercontent.com/u/2454505?v=4)](https://github.com/robinjoseph08 "robinjoseph08 (5 commits)")[![graysonchao](https://avatars.githubusercontent.com/u/1198863?v=4)](https://github.com/graysonchao "graysonchao (4 commits)")[![elnaz](https://avatars.githubusercontent.com/u/1043187?v=4)](https://github.com/elnaz "elnaz (4 commits)")[![russelltaylor05](https://avatars.githubusercontent.com/u/2423220?v=4)](https://github.com/russelltaylor05 "russelltaylor05 (4 commits)")[![amaan-lob](https://avatars.githubusercontent.com/u/72472696?v=4)](https://github.com/amaan-lob "amaan-lob (3 commits)")[![charlesbjohnson](https://avatars.githubusercontent.com/u/4823640?v=4)](https://github.com/charlesbjohnson "charlesbjohnson (3 commits)")[![SishaarRao](https://avatars.githubusercontent.com/u/20084278?v=4)](https://github.com/SishaarRao "SishaarRao (3 commits)")[![aarondfrancis](https://avatars.githubusercontent.com/u/881931?v=4)](https://github.com/aarondfrancis "aarondfrancis (2 commits)")[![brianseitel](https://avatars.githubusercontent.com/u/503048?v=4)](https://github.com/brianseitel "brianseitel (2 commits)")

---

Tags

phpapisdkrestopenapiopenapitoolsopenapi-generator

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/blackcart-lob-php/health.svg)

```
[![Health](https://phpackages.com/badges/blackcart-lob-php/health.svg)](https://phpackages.com/packages/blackcart-lob-php)
```

###  Alternatives

[lob/lob-php

The Lob API is organized around REST. Our API is designed to have predictable, resource-oriented URLs and uses HTTP response codes to indicate any API errors.

684.2M4](/packages/lob-lob-php)[elasticemail/elasticemail-php

The PHP library for the Elastic Email REST API. This API is based on the REST API architecture, allowing the user to easily manage their data with this resource-based approach. To start using this API, you will need your Access Token. Remember to keep it safe.

15114.7k2](/packages/elasticemail-elasticemail-php)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

273.0k](/packages/eslazarev-wildberries-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
