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)
     {

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
             );
         }