Antidot-be / bpost-api-library

src/Bpost.php

Doc Comments +3 added lines, -3 removed lines

@@ -184,10 +184,10 @@ 
      *
      * @param  string $url       The URL to call.
      * @param  string $body      The data to pass.
-     * @param  array  $headers   The headers to pass.
+     * @param  string[]  $headers   The headers to pass.
      * @param  string $method    The HTTP-method to use.
      * @param  bool   $expectXML Do we expect XML?
-     * @return mixed
+     * @return \SimpleXMLElement
      * @throws BpostCurlException
      * @throws BpostInvalidResponseException
      * @throws BpostInvalidSelectionException
@@ -509,7 +509,7 @@ 
     /**
      * Get the possible label formats
      *
-     * @return array
+     * @return string[]
      */
     public static function getPossibleLabelFormatValues()
     {

Spacing +22 added lines, -22 removed lines

@@ -98,9 +98,9 @@ 
      */
     public function __construct($accountId, $passPhrase, $apiUrl = self::API_URL)
     {
-        $this->accountId = (string)$accountId;
-        $this->passPhrase = (string)$passPhrase;
-        $this->apiUrl = (string)$apiUrl;
+        $this->accountId = (string) $accountId;
+        $this->passPhrase = (string) $passPhrase;
+        $this->apiUrl = (string) $apiUrl;
         $this->logger = new Logger();
     }
 
@@ -141,17 +141,17 @@ 
 
         /** @var \SimpleXMLElement $value */
         foreach ($item as $key => $value) {
-            $attributes = (array)$value->attributes();
+            $attributes = (array) $value->attributes();
 
             if (!empty($attributes) && isset($attributes['@attributes'])) {
                 $return[$key]['@attributes'] = $attributes['@attributes'];
             }
 
             // empty
-            if (isset($value['nil']) && (string)$value['nil'] === 'true') {
+            if (isset($value['nil']) && (string) $value['nil'] === 'true') {
                 $return[$key] = null;
             } // empty
-            elseif (isset($value[0]) && (string)$value == '') {
+            elseif (isset($value[0]) && (string) $value == '') {
                 if (in_array($key, $arrayKeys)) {
                     $return[$key][] = self::decodeResponse($value);
                 } else {
@@ -160,18 +160,18 @@ 
             } else {
                 // arrays
                 if (in_array($key, $arrayKeys)) {
-                    $return[$key][] = (string)$value;
+                    $return[$key][] = (string) $value;
                 } // booleans
-                elseif ((string)$value == 'true') {
+                elseif ((string) $value == 'true') {
                     $return[$key] = true;
-                } elseif ((string)$value == 'false') {
+                } elseif ((string) $value == 'false') {
                     $return[$key] = false;
                 } // integers
                 elseif (in_array($key, $integerKeys)) {
-                    $return[$key] = (int)$value;
+                    $return[$key] = (int) $value;
                 } // fallback to string
                 else {
-                    $return[$key] = (string)$value;
+                    $return[$key] = (string) $value;
                 }
             }
         }
@@ -204,7 +204,7 @@ 
         }
         $options[CURLOPT_USERAGENT] = $this->getUserAgent();
         $options[CURLOPT_RETURNTRANSFER] = true;
-        $options[CURLOPT_TIMEOUT] = (int)$this->getTimeOut();
+        $options[CURLOPT_TIMEOUT] = (int) $this->getTimeOut();
         $options[CURLOPT_HTTP_VERSION] = CURL_HTTP_VERSION_1_1;
         $options[CURLOPT_HTTPHEADER] = $headers;
 
@@ -249,8 +249,8 @@ 
             if ($xml !== false && (substr($xml->getName(), 0, 7) == 'invalid')
             ) {
                 // message
-                $message = (string)$xml->error;
-                $code = isset($xml->code) ? (int)$xml->code : null;
+                $message = (string) $xml->error;
+                $code = isset($xml->code) ? (int) $xml->code : null;
 
                 // throw exception
                 throw new BpostInvalidSelectionException($message, $code);
@@ -316,7 +316,7 @@ 
      */
     public function getPort()
     {
-        return (int)$this->port;
+        return (int) $this->port;
     }
 
     /**
@@ -326,7 +326,7 @@ 
      */
     public function getTimeOut()
     {
-        return (int)$this->timeOut;
+        return (int) $this->timeOut;
     }
 
     /**
@@ -338,7 +338,7 @@ 
      */
     public function getUserAgent()
     {
-        return (string)'PHP Bpost/' . self::VERSION . ' ' . $this->userAgent;
+        return (string) 'PHP Bpost/' . self::VERSION . ' ' . $this->userAgent;
     }
 
     /**
@@ -349,7 +349,7 @@ 
      */
     public function setTimeOut($seconds)
     {
-        $this->timeOut = (int)$seconds;
+        $this->timeOut = (int) $seconds;
     }
 
     /**
@@ -360,7 +360,7 @@ 
      */
     public function setUserAgent($userAgent)
     {
-        $this->userAgent = (string)$userAgent;
+        $this->userAgent = (string) $userAgent;
     }
 
     // webservice methods
@@ -418,7 +418,7 @@ 
      */
     public function fetchOrder($reference)
     {
-        $url = '/orders/' . (string)$reference;
+        $url = '/orders/' . (string) $reference;
 
         $headers = array(
             'Accept: application/vnd.bpost.shm-order-v3.3+XML',
@@ -584,7 +584,7 @@ 
         $withReturnLabels = false,
         $asPdf = false
     ) {
-        $url = '/orders/' . (string)$reference;
+        $url = '/orders/' . (string) $reference;
 
         return $this->getLabel($url, $format, $withReturnLabels, $asPdf);
     }
@@ -606,7 +606,7 @@ 
         $withReturnLabels = false,
         $asPdf = false
     ) {
-        $url = '/boxes/' . (string)$barcode;
+        $url = '/boxes/' . (string) $barcode;
 
         return $this->getLabel($url, $format, $withReturnLabels, $asPdf);
     }

src/Bpost/Order/Box.php

Doc Comments +1 added lines, -1 removed lines

@@ -173,7 +173,7 @@
     }
 
     /**
-     * @return array
+     * @return string[]
      */
     public static function getPossibleStatusValues()
     {

Spacing +2 added lines, -2 removed lines

@@ -161,7 +161,7 @@ 
      */
     public function setAdditionalCustomerReference($additionalCustomerReference)
     {
-        $this->additionalCustomerReference = (string)$additionalCustomerReference;
+        $this->additionalCustomerReference = (string) $additionalCustomerReference;
     }
 
     /**
@@ -325,7 +325,7 @@ 
             $box->setRemark((string) $xml->remark);
         }
         if (isset($xml->additionalCustomerReference) && $xml->additionalCustomerReference != '') {
-            $box->setAdditionalCustomerReference((string)$xml->additionalCustomerReference);
+            $box->setAdditionalCustomerReference((string) $xml->additionalCustomerReference);
         }
         if (!empty($xml->barcode)) {
             $box->setBarcode((string) $xml->barcode);

src/Bpost/Order/Box/AtBpost.php

Doc Comments +3 added lines

@@ -239,6 +239,9 @@
         }
     }
 
+    /**
+     * @param string|null $prefix
+     */
     private function addToXmlShopHandlingInstruction(\DOMDocument $document, \DOMElement $typeElement, $prefix)
     {
         if ($this->getShopHandlingInstruction() !== null) {

Spacing +8 added lines, -8 removed lines

@@ -261,7 +261,7 @@ 
 
         if (isset($xml->atBpost->product) && $xml->atBpost->product != '') {
             $atBpost->setProduct(
-                (string)$xml->atBpost->product
+                (string) $xml->atBpost->product
             );
         }
         if (isset($xml->atBpost->options)) {
@@ -296,27 +296,27 @@ 
         }
         if (isset($xml->atBpost->weight) && $xml->atBpost->weight != '') {
             $atBpost->setWeight(
-                (int)$xml->atBpost->weight
+                (int) $xml->atBpost->weight
             );
         }
         if (isset($xml->atBpost->receiverName) && $xml->atBpost->receiverName != '') {
             $atBpost->setReceiverName(
-                (string)$xml->atBpost->receiverName
+                (string) $xml->atBpost->receiverName
             );
         }
         if (isset($xml->atBpost->receiverCompany) && $xml->atBpost->receiverCompany != '') {
             $atBpost->setReceiverCompany(
-                (string)$xml->atBpost->receiverCompany
+                (string) $xml->atBpost->receiverCompany
             );
         }
         if (isset($xml->atBpost->pugoId) && $xml->atBpost->pugoId != '') {
             $atBpost->setPugoId(
-                (string)$xml->atBpost->pugoId
+                (string) $xml->atBpost->pugoId
             );
         }
         if (isset($xml->atBpost->pugoName) && $xml->atBpost->pugoName != '') {
             $atBpost->setPugoName(
-                (string)$xml->atBpost->pugoName
+                (string) $xml->atBpost->pugoName
             );
         }
         if (isset($xml->atBpost->pugoAddress)) {
@@ -330,12 +330,12 @@ 
         }
         if (isset($xml->atBpost->requestedDeliveryDate) && $xml->atBpost->requestedDeliveryDate != '') {
             $atBpost->setRequestedDeliveryDate(
-                (string)$xml->atBpost->requestedDeliveryDate
+                (string) $xml->atBpost->requestedDeliveryDate
             );
         }
         if (isset($xml->atBpost->shopHandlingInstruction) && $xml->atBpost->shopHandlingInstruction != '') {
             $atBpost->setShopHandlingInstruction(
-                (string)$xml->atBpost->shopHandlingInstruction
+                (string) $xml->atBpost->shopHandlingInstruction
             );
         }
 

src/Bpost/Order/Box/National/ParcelLockerReducedMobilityZone.php

Doc Comments +1 added lines, -1 removed lines

@@ -24,7 +24,7 @@
     /**
      * @todo Implement it, because today, nothing is specified
      * @param \SimpleXMLElement $xml
-     * @return ParcelLockerReducedMobilityZone|\Bpost\BpostApiClient\IComplexAttribute
+     * @return ParcelLockerReducedMobilityZone
      */
     static function createFromXml(\SimpleXMLElement $xml)
     {

src/Geo6/Poi.php

Doc Comments +2 added lines, -2 removed lines

@@ -109,7 +109,7 @@ 
     }
 
     /**
-     * @param array $closedFrom
+     * @param string $closedFrom
      */
     public function setClosedFrom($closedFrom)
     {
@@ -125,7 +125,7 @@ 
     }
 
     /**
-     * @param array $closedTo
+     * @param string $closedTo
      */
     public function setClosedTo($closedTo)
     {

Spacing +34 added lines, -34 removed lines

@@ -70,7 +70,7 @@ 
      */
     public function setCity($city)
     {
-        $this->city = (string)$city;
+        $this->city = (string) $city;
     }
 
     /**
@@ -119,7 +119,7 @@ 
      */
     public function addHour($index, Day $day)
     {
-        $this->hours[(int)$index] = $day;
+        $this->hours[(int) $index] = $day;
     }
 
     /**
@@ -143,7 +143,7 @@ 
      */
     public function setId($id)
     {
-        $this->id = (string)$id;
+        $this->id = (string) $id;
     }
 
     /**
@@ -159,7 +159,7 @@ 
      */
     public function setLatitude($latitude)
     {
-        $this->latitude = (float)$latitude;
+        $this->latitude = (float) $latitude;
     }
 
     /**
@@ -175,7 +175,7 @@ 
      */
     public function setLongitude($longitude)
     {
-        $this->longitude = (float)$longitude;
+        $this->longitude = (float) $longitude;
     }
 
     /**
@@ -191,7 +191,7 @@ 
      */
     public function setNote($note)
     {
-        $this->note = (string)$note;
+        $this->note = (string) $note;
     }
 
     /**
@@ -207,7 +207,7 @@ 
      */
     public function setNr($nr)
     {
-        $this->nr = (string)$nr;
+        $this->nr = (string) $nr;
     }
 
     /**
@@ -223,7 +223,7 @@ 
      */
     public function setOffice($office)
     {
-        $this->office = (string)$office;
+        $this->office = (string) $office;
     }
 
     /**
@@ -263,7 +263,7 @@ 
      */
     public function setStreet($street)
     {
-        $this->street = (string)$street;
+        $this->street = (string) $street;
     }
 
     /**
@@ -279,7 +279,7 @@ 
      */
     public function setType($type)
     {
-        $this->type = (string)$type;
+        $this->type = (string) $type;
     }
 
     /**
@@ -295,7 +295,7 @@ 
      */
     public function setX($x)
     {
-        $this->x = (int)$x;
+        $this->x = (int) $x;
     }
 
     /**
@@ -311,7 +311,7 @@ 
      */
     public function setY($y)
     {
-        $this->y = (int)$y;
+        $this->y = (int) $y;
     }
 
     /**
@@ -327,7 +327,7 @@ 
      */
     public function setZip($zip)
     {
-        $this->zip = (string)$zip;
+        $this->zip = (string) $zip;
     }
 
     /**
@@ -351,7 +351,7 @@ 
      */
     public function setPage($page)
     {
-        $this->page = (string)$page;
+        $this->page = (string) $page;
     }
 
 
@@ -373,55 +373,55 @@ 
         $poi = new Poi();
 
         if (isset($recordXml->Id) && $recordXml->Id != '') {
-            $poi->setId((string)$recordXml->Id);
+            $poi->setId((string) $recordXml->Id);
         }
         if (isset($recordXml->ID) && $recordXml->ID != '') {
-            $poi->setId((string)$recordXml->ID);
+            $poi->setId((string) $recordXml->ID);
         }
         if (isset($recordXml->Type) && $recordXml->Type != '') {
-            $poi->setType((string)$recordXml->Type);
+            $poi->setType((string) $recordXml->Type);
         }
         if (isset($recordXml->Name) && $recordXml->Name != '') {
-            $poi->setOffice((string)$recordXml->Name);
+            $poi->setOffice((string) $recordXml->Name);
         }
         if (isset($recordXml->OFFICE) && $recordXml->OFFICE != '') {
-            $poi->setOffice((string)$recordXml->OFFICE);
+            $poi->setOffice((string) $recordXml->OFFICE);
         }
         if (isset($recordXml->Street) && $recordXml->Street != '') {
-            $poi->setStreet((string)$recordXml->Street);
+            $poi->setStreet((string) $recordXml->Street);
         }
         if (isset($recordXml->STREET) && $recordXml->STREET != '') {
-            $poi->setStreet((string)$recordXml->STREET);
+            $poi->setStreet((string) $recordXml->STREET);
         }
         if (isset($recordXml->Number) && $recordXml->Number != '') {
-            $poi->setNr((string)$recordXml->Number);
+            $poi->setNr((string) $recordXml->Number);
         }
         if (isset($recordXml->NR) && $recordXml->NR != '') {
-            $poi->setNr((string)$recordXml->NR);
+            $poi->setNr((string) $recordXml->NR);
         }
         if (isset($recordXml->Zip) && $recordXml->Zip != '') {
-            $poi->setZip((string)$recordXml->Zip);
+            $poi->setZip((string) $recordXml->Zip);
         }
         if (isset($recordXml->ZIP) && $recordXml->ZIP != '') {
-            $poi->setZip((string)$recordXml->ZIP);
+            $poi->setZip((string) $recordXml->ZIP);
         }
         if (isset($recordXml->City) && $recordXml->City != '') {
-            $poi->setCity((string)$recordXml->City);
+            $poi->setCity((string) $recordXml->City);
         }
         if (isset($recordXml->CITY) && $recordXml->CITY != '') {
-            $poi->setCity((string)$recordXml->CITY);
+            $poi->setCity((string) $recordXml->CITY);
         }
         if (isset($recordXml->X) && $recordXml->X != '') {
-            $poi->setX((int)$recordXml->X);
+            $poi->setX((int) $recordXml->X);
         }
         if (isset($recordXml->Y) && $recordXml->Y != '') {
-            $poi->setY((int)$recordXml->Y);
+            $poi->setY((int) $recordXml->Y);
         }
         if (isset($recordXml->Longitude) && $recordXml->Longitude != '') {
-            $poi->setLongitude((float)$recordXml->Longitude);
+            $poi->setLongitude((float) $recordXml->Longitude);
         }
         if (isset($recordXml->Latitude) && $recordXml->Latitude != '') {
-            $poi->setLatitude((float)$recordXml->Latitude);
+            $poi->setLatitude((float) $recordXml->Latitude);
         }
         if (isset($recordXml->Services) && isset($recordXml->Services->Service)) {
             foreach ($recordXml->Services->Service as $service) {
@@ -456,13 +456,13 @@ 
         }
 
         if (isset($recordXml->ClosedFrom) && $recordXml->ClosedFrom != '') {
-            $poi->setClosedFrom((string)$recordXml->ClosedFrom);
+            $poi->setClosedFrom((string) $recordXml->ClosedFrom);
         }
         if (isset($recordXml->ClosedTo) && $recordXml->ClosedTo != '') {
-            $poi->setClosedTo((string)$recordXml->ClosedTo);
+            $poi->setClosedTo((string) $recordXml->ClosedTo);
         }
         if (isset($recordXml->NOTE) && $recordXml->NOTE != '') {
-            $poi->setNote((string)$recordXml->NOTE);
+            $poi->setNote((string) $recordXml->NOTE);
         }
 
         if (isset($xml->Page) && isset($xml->Page['ServiceRef']) && $xml->Page['ServiceRef'] != '') {

src/Bpost/Order/Box/National/UnregisteredParcelLockerMember.php

Spacing +3 added lines, -3 removed lines

@@ -162,15 +162,15 @@
         $self = new self();
 
         if (isset($xml->language) && $xml->language != '') {
-            $self->setLanguage((string)$xml->language);
+            $self->setLanguage((string) $xml->language);
         }
 
         if (isset($xml->mobilePhone) && $xml->mobilePhone != '') {
-            $self->setMobilePhone((string)$xml->mobilePhone);
+            $self->setMobilePhone((string) $xml->mobilePhone);
         }
 
         if (isset($xml->emailAddress) && $xml->emailAddress != '') {
-            $self->setEmailAddress((string)$xml->emailAddress);
+            $self->setEmailAddress((string) $xml->emailAddress);
         }
 
         if (isset($xml->parcelLockerReducedMobilityZone)) {

src/Bpost/Order/Box/AtHome.php

Spacing +1 added lines, -1 removed lines

@@ -80,7 +80,7 @@
      */
     public function setRequestedDeliveryDate($requestedDeliveryDate)
     {
-        $this->requestedDeliveryDate = (string)$requestedDeliveryDate;
+        $this->requestedDeliveryDate = (string) $requestedDeliveryDate;
     }
 
     /**

src/Bpost/Order/Box/At247.php

Spacing +9 added lines, -9 removed lines

@@ -193,7 +193,7 @@ 
      */
     public function setRequestedDeliveryDate($requestedDeliveryDate)
     {
-        $this->requestedDeliveryDate = (string)$requestedDeliveryDate;
+        $this->requestedDeliveryDate = (string) $requestedDeliveryDate;
     }
 
     /**
@@ -306,7 +306,7 @@ 
 
         if (isset($xml->{'at24-7'}->product) && $xml->{'at24-7'}->product != '') {
             $at247->setProduct(
-                (string)$xml->{'at24-7'}->product
+                (string) $xml->{'at24-7'}->product
             );
         }
         if (isset($xml->{'at24-7'}->options)) {
@@ -332,32 +332,32 @@ 
         }
         if (isset($xml->{'at24-7'}->weight) && $xml->{'at24-7'}->weight != '') {
             $at247->setWeight(
-                (int)$xml->{'at24-7'}->weight
+                (int) $xml->{'at24-7'}->weight
             );
         }
         if (isset($xml->{'at24-7'}->memberId) && $xml->{'at24-7'}->memberId != '') {
             $at247->setMemberId(
-                (string)$xml->{'at24-7'}->memberId
+                (string) $xml->{'at24-7'}->memberId
             );
         }
         if (isset($xml->{'at24-7'}->receiverName) && $xml->{'at24-7'}->receiverName != '') {
             $at247->setReceiverName(
-                (string)$xml->{'at24-7'}->receiverName
+                (string) $xml->{'at24-7'}->receiverName
             );
         }
         if (isset($xml->{'at24-7'}->receiverCompany) && $xml->{'at24-7'}->receiverCompany != '') {
             $at247->setReceiverCompany(
-                (string)$xml->{'at24-7'}->receiverCompany
+                (string) $xml->{'at24-7'}->receiverCompany
             );
         }
         if (isset($xml->{'at24-7'}->parcelsDepotId) && $xml->{'at24-7'}->parcelsDepotId != '') {
             $at247->setParcelsDepotId(
-                (string)$xml->{'at24-7'}->parcelsDepotId
+                (string) $xml->{'at24-7'}->parcelsDepotId
             );
         }
         if (isset($xml->{'at24-7'}->parcelsDepotName) && $xml->{'at24-7'}->parcelsDepotName != '') {
             $at247->setParcelsDepotName(
-                (string)$xml->{'at24-7'}->parcelsDepotName
+                (string) $xml->{'at24-7'}->parcelsDepotName
             );
         }
         if (isset($xml->{'at24-7'}->parcelsDepotAddress)) {
@@ -371,7 +371,7 @@ 
         }
         if (isset($xml->{'at24-7'}->requestedDeliveryDate) && $xml->{'at24-7'}->requestedDeliveryDate != '') {
             $at247->setRequestedDeliveryDate(
-                (string)$xml->{'at24-7'}->requestedDeliveryDate
+                (string) $xml->{'at24-7'}->requestedDeliveryDate
             );
         }
 

src/Bpost/Order/Box/BpostOnAppointment.php

Spacing +2 added lines, -2 removed lines

@@ -45,7 +45,7 @@ 
      */
     public function setInNetworkCutOff($inNetworkCutOff)
     {
-        $this->inNetworkCutOff = (string)$inNetworkCutOff;
+        $this->inNetworkCutOff = (string) $inNetworkCutOff;
     }
 
     /**
@@ -124,7 +124,7 @@ 
 
         if (isset($bpostOnAppointmentXml->inNetworkCutOff) && $bpostOnAppointmentXml->inNetworkCutOff != '') {
             $self->setInNetworkCutOff(
-                (string)$bpostOnAppointmentXml->inNetworkCutOff
+                (string) $bpostOnAppointmentXml->inNetworkCutOff
             );
         }