petschko / dhl-php-sdk
DHL SDK
Installs: 78 866
Dependents: 3
Suggesters: 1
Security: 0
Stars: 91
Watchers: 25
Forks: 49
Open Issues: 6
Requires
- php: >=7.2.0
- ext-mbstring: *
- ext-soap: *
README
** This REPO is out of support ** Please checkout other repos or request examples from DHL
In case you still have questions, you can send me an E-Mail or visit this Project on Gitlab.com
DHL PHP SDK
This unofficial library is wrapping some functions of the DHL SOAP API in order to easy create/delete shipments and labels.
Requirements
- You need a DHL developer Account and - as long as you want to use the API in production systems - a DHL Intraship Account.
- PHP-Version 5.4 or higher (It may work on older Versions, but I don't offer Support for these)
- PHP-SOAP-Client installed + enabled on your Server. More information on php.net
Installation
Composer
You can use Composer to install the package to your project:
composer require petschko/dhl-php-sdk
The classes are then added to the autoloader automatically.
Without Composer
If you can't use Composer (or don't want to), you can also use this SDK without it.
To initial this SDK, just require the _nonComposerLoader.php-File from the /includes/
directory.
require_once(__DIR__ . '/includes/_nonComposerLoader.php');
Compatibility
This Project is written for the DHL-SOAP-API Version 2 or higher.
API Version 3.0
This Project is currently not available for Version 3.0+, I plan to update it soon! Please don't send me any E-Mails about this! If you want to talk about Version 3.0, please use the Issue for it: #64
Use BETA for Version 3.0
You can still try out the dev-branch of this repo for Version 3:
composer require petschko/dhl-php-sdk:dev-dev
Version 1
Version 1 Methods are marked as deprecated and will removed soon. Please upgrade to the API-Version 2 as soon as possible.
Usage / Getting started
- Getting started (Just a quick guide how you have to use it)
- More examples soon
Please have a look at the examples
Directory. There you can find how to use this SDK also with Code-Examples, else check the (Doxygen) Documentation for deeper knowledge.
Code Documentation
You find Code-Examples with explanations in the examples
Directory. I also explain how it works.
You can find a Code-Reference here: (Doxygen) http://docs.petschko.org/dhl-php-sdk/index.html
Motivation
I had a lot of pain studying and programming the DHL SOAP API - just to wrap some bits in a lot of XML. There is a lot, but not very helpful, documentation to the API. So I decided to create some functions in an easy to use and understand library.
There is also a lot of old stuff in the Documentation, so that you can not sure if it is right...
Credits
All these Persons helped to create this SDK for the DHL-API:
- aschempp - For the help with the Notification E-Mail
- cedricziel - For turning this Project into a Composer-Package
- Dakror - For the
ProductInfo
-Class - octlabs - For adding some missing Documentation
- Petschko - Initially created this Project and decided to share it for free
- tobias-redmann - For the
setFullStreet
method and the PHP-DHL-Example-Project for Version 1 (This helped a lot to understand how the API works)
Donate
If you like this Project may consider to Donate. I usually do this Project in my spare time and it's completely free. So I appreciate anything, which helps the Project (Pull-Requests, Bug Report etc), these are more worth than Donations but I'm happy for every amount as well. ^.^
Contact
- You can E-Mail me if you have Questions or whatever (No Bug-Reporting please!): peter@petschko.org
- You can Chat with me in Telegram
@petschkoo
- You can Report Bugs here in the "Issue"-Section of the Project.
- Of course you can also ask any stuff there, feel free for that!
- If you want to use German, you can do it. Please keep in mind that not everybody can speak German, so it's better to use english =)