PHPackages                             3rdpartyeve/perry - 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. [API Development](/categories/api)
4. /
5. 3rdpartyeve/perry

AbandonedArchivedLibrary[API Development](/categories/api)

3rdpartyeve/perry
=================

A PHP Library to access EVE Online's CREST API

2.0.0(10y ago)91.4k7MITPHP

Since Sep 7Pushed 10y ago1 watchersCompare

[ Source](https://github.com/3rdpartyeve/perry)[ Packagist](https://packagist.org/packages/3rdpartyeve/perry)[ RSS](/packages/3rdpartyeve-perry/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependencies (2)Versions (30)Used By (0)

DEPRECATED
==========

[](#deprecated)

I've build this library before the 3rd Party License by CCP was put into place, hence you can only see stuff that was available to that point. As I don't feel that I as a developer of this library am properly covered, and as all tries to talk with ccp about it run into nowhere, i haven't been adding features since.

Which means: some of the classes for the representations are outdated (in case they got v2 representations for example), some things provided by crest nowadays where never implemented, and furthermore, there is no implementation for the stuff that requires the single sign on (as that requires the license).

You are free to fork &amp; use this library, extend it, rewrite it or whatever else you want to do, the code is under MIT license, and will stay so, however I might not answer bug reports, take pull requests or do any other work on this - if you want to take over maintaining it, feel free to contact me.

until a maintainer is found, I can not recommend the usage of this project.

best regards, Peter "Peter Powers" Petermann

[![Latest Stable Version](https://camo.githubusercontent.com/b3e17e23615b316e4602d7cc394598cec9a128b7f2a9a6255a70f85add7077dd/68747470733a2f2f706f7365722e707567782e6f72672f33726470617274796576652f70657272792f762f737461626c652e706e67)](https://packagist.org/packages/3rdpartyeve/perry)[![Total Downloads](https://camo.githubusercontent.com/0beacc539e73ce3b2f00f41d899075c960c88e638ce67fd8708691d5d09cca31/68747470733a2f2f706f7365722e707567782e6f72672f33726470617274796576652f70657272792f646f776e6c6f6164732e706e67)](https://packagist.org/packages/3rdpartyeve/perry)[![Scrutinizer Quality Score](https://camo.githubusercontent.com/f7c32423baa70f04b4a98868044a445a64b201a09a5863c3aace7a2d9959fae4/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f33726470617274796576652f70657272792f6261646765732f7175616c6974792d73636f72652e706e673f733d61626133643230376532363937656633633235663336313766303734316336396366613239333836)](https://scrutinizer-ci.com/g/3rdpartyeve/perry/)[![Code Coverage](https://camo.githubusercontent.com/017d2f44121e985b381d090cb72c07f138c87f377ada6e03438c0b63b2396366/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f33726470617274796576652f70657272792f6261646765732f636f7665726167652e706e673f733d38356433633637393863613936373236393631633765346661343035396162393230366263373836)](https://scrutinizer-ci.com/g/3rdpartyeve/perry/)

Perry
=====

[](#perry)

a PHP Library for accessing EVE Online's CREST API

WARNING
-------

[](#warning)

this is a prototype / work in progress. As CCP has not released much of the CREST API yet its use is extremely limited, also this library is not to be considered complete or stable, most likely backward compatibility will break during further development. Do not use this if you don't know what you are doing.

Status on the Completeness:
---------------------------

[](#status-on-the-completeness)

Implemented:

- [https://forums.dust514.com/default.aspx?g=posts&amp;t=103783](https://forums.dust514.com/default.aspx?g=posts&t=103783) (districts have alot of references which dont resolve yet, also for some of those references i made guessing on what exactly they might refer to, so even when those are published there might be some extra work needed)
- [https://forums.eveonline.com/default.aspx?g=posts&amp;t=257854](https://forums.eveonline.com/default.aspx?g=posts&t=257854)
- [https://forums.eveonline.com/default.aspx?g=posts&amp;m=3393341#post3393341](https://forums.eveonline.com/default.aspx?g=posts&m=3393341#post3393341) (Realtime Tournament Stuff)
- Killmail API
- [https://forums.eveonline.com/default.aspx?g=posts&amp;m=4303155](https://forums.eveonline.com/default.aspx?g=posts&m=4303155) (Alliances, Incursions)
- [https://neweden-dev.com/CREST\_Market\_History](https://neweden-dev.com/CREST_Market_History) (Market History)

Removed:

- [https://wiki.eveonline.com/en/wiki/CREST\_Documentation](https://wiki.eveonline.com/en/wiki/CREST_Documentation) (while those are documented for ages, this endpoint has never been published. There is even a chance it has changed within Crest. Classes for it will come back once it is public.

Also you might find some files to access Thora, a Proxy for the old API, which is mostly not working yet, so don't use it.

Also have a look at the bottom of this README, it contains a list of all known issues.

LICENSE
-------

[](#license)

This library is released under the MIT style license. See LICENSE.txt for details.

REQUIREMENTS
------------

[](#requirements)

- PHP 5.4+
- Composer:

INSTALLATION
------------

[](#installation)

### Assumptions

[](#assumptions)

A few assumptions are made before you start:

1. you are on linux, and you have commandline access.
2. you know how to handle yourself on linux
3. the requirements (see README) are installed.

### Quick Install

[](#quick-install)

Perry is installed and updated through the great composer dependency management, it is available through Packagist, so your composer installer should find the packages by default.

If you don't know your way around with composer, have never used it and need examples, please go to  and read up on it. Composer is a great system, and if you are serious about PHP development you should know it.

add either (releases)

- "3rdpartyeve/perry": "1.0.\*" or (dev-master, changing source)
- "3rdpartyeve/perry": "dev-master" to your composer.json

USAGE
-----

[](#usage)

### Cache

[](#cache)

Perry comes with build in caching of the requested CREST Pages. Perry is compliant with PSR-6 (at the currents draft state). Since PSR-6 has not been finalized / released yet, at the moment it also contains the Interfaces PSR-6 is defining. Once PSR-6 is available, those will be removed from the Lib.

By default Perry has the Cache DISABLED, meaning if you want any sort of caching, you have to enable it. To enable Caching in Perry you simply give the Setup Singleton an instance of a PSR-6 Compliant Cache.

With Perry you get an extremly simple file cache, which takes a path in the constructor, that it then will fill with cache files. If you use it keep in mind that those are not deleted automatically.

The TTL for the cache is by default 5 minutes, see the example below for how to change it.

```
