A PHP wrapper for the JokeAPI.

Currently, this package is not available on Packagist. To use it, simply clone this repository:

git clone https://github.com/yourusername/jokeapi-php.git

<?php require_once 'path/to/JokeAPI/JokeClient.php'; use JokeAPI\JokeClient; use JokeAPI\JokeConstants; // Create a new JokeClient $client = new JokeClient(); // Get a random joke $joke = $client->fetch(); // Print the joke if ($joke['type'] === 'single') { echo $joke['joke']; } else { echo "Setup: " . $joke['setup'] . "\n"; echo "Delivery: " . $joke['delivery']; }

The JokeAPI PHP client supports all the features of the JokeAPI:

• Multiple categories
• Blacklist flags
• Different formats (JSON, XML)
• Joke types (single, twopart)
• Search functionality
• Specific joke IDs
• Multiple languages
• Safe mode

Set the categories for the jokes.

$client->categories([ JokeConstants::CATEGORY_PROGRAMMING, JokeConstants::CATEGORY_MISC ]);

Available categories:

• CATEGORY_ANY (default)
• CATEGORY_MISC
• CATEGORY_PROGRAMMING
• CATEGORY_DARK
• CATEGORY_PUN
• CATEGORY_SPOOKY
• CATEGORY_CHRISTMAS

Set blacklist flags to filter jokes.

$client->blacklist([ JokeConstants::FLAG_NSFW, JokeConstants::FLAG_RELIGIOUS ]);

Available flags:

• FLAG_NSFW
• FLAG_RELIGIOUS
• FLAG_POLITICAL
• FLAG_RACIST
• FLAG_SEXIST
• FLAG_EXPLICIT

Set the response format (json or xml).

$client->format('xml');

Set the joke type (single or twopart).

$client->type(JokeConstants::TYPE_SINGLE);

Available types:

• TYPE_SINGLE
• TYPE_TWOPART

Search for jokes containing the specified string.

$client->search('programmer');

Get a joke by ID.

$client->id(42);

Set the language for the jokes.

$client->language(JokeConstants::LANG_GERMAN);

Available languages:

• LANG_ENGLISH (default)
• LANG_CZECH
• LANG_GERMAN
• LANG_SPANISH
• LANG_FRENCH
• LANG_PORTUGUESE

Enable safe mode (excludes nsfw jokes).

$client->safe();

Fetch a joke from the API.

$joke = $client->fetch();

All methods (except fetch()) return the client instance for method chaining:

$joke = $client ->categories([JokeConstants::CATEGORY_PROGRAMMING]) ->blacklist([JokeConstants::FLAG_NSFW]) ->safe() ->fetch();

MIT

This is a PHP port of the jokeapi Go package by Icelain.