Download the PHP package truelist/truelist-php without Composer

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

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 truelist/truelist-php

Informations about the package truelist-php

Truelist PHP SDK

Free tier PHP SDK for the Truelist email validation API.

CI

Requirements

Start free — 100 validations + 10 enhanced credits, no credit card required. Get your API key →

Installation

Quick Start

Configuration

Option Default Description
base_url https://api.truelist.io API base URL
timeout 10 Request timeout in seconds
max_retries 2 Number of retries on 429/5xx errors (with exponential backoff)
raise_on_error false When false, transient errors return an unknown result. When true, they throw.

Methods

validate(string $email): ValidationResult

Validates an email address. Sends a POST to /api/v1/verify_inline with the email as a query parameter.

account(): AccountInfo

Retrieves account information from GET /me.

Result Predicates

Response States

State Description
ok Email is valid and deliverable
email_invalid Email is not deliverable
accept_all Domain accepts all emails (catch-all)
unknown Could not determine validity

Response Sub-States

Sub-State Description
email_ok Email is valid
is_disposable Disposable/temporary email
is_role Role-based address (info@, admin@)
failed_smtp_check SMTP check failed
unknown_error Could not determine

Error Handling

The SDK uses a hierarchy of exceptions:

Auth Errors Always Throw

Authentication errors (HTTP 401) always throw an AuthenticationException, regardless of the raise_on_error setting.

Transient Error Behavior

For transient errors (429, 5xx, timeouts), behavior depends on raise_on_error:

Retry Behavior

The SDK automatically retries on 429 and 5xx errors with exponential backoff. Configure with max_retries (default: 2). Auth errors (401) are never retried.

Testing

Getting Started

Sign up for a free Truelist account to get your API key. The free plan includes 100 validations and 10 enhanced credits — no credit card required.

License

MIT

All versions of truelist-php with dependencies

PHP Build Version
Package Version
Requires php Version ^8.1
guzzlehttp/guzzle Version ^7.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 truelist/truelist-php contains the following files

Loading the files please wait ...