Clientbase
/
PhpSpreadsheet
mirror of https://github.com/basemaster/PhpSpreadsheet.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Apply some coercive type-hinting

This commit is contained in:
MarkBaker 2022-06-11 14:32:29 +02:00
parent 5cba6d86e6
commit 189152ee07
4 changed files with 37 additions and 93 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
phpstan-baseline.neon
View File

@ -3115,26 +3115,6 @@ parameters:
count: 1 count: 1
path: src/PhpSpreadsheet/Shared/StringHelper.php path: src/PhpSpreadsheet/Shared/StringHelper.php
-
message: "#^Method PhpOffice\\\\PhpSpreadsheet\\\\Shared\\\\StringHelper\\:\\:mbIsUpper\\(\\) has no return type specified\\.$#"
count: 1
path: src/PhpSpreadsheet/Shared/StringHelper.php
-
message: "#^Method PhpOffice\\\\PhpSpreadsheet\\\\Shared\\\\StringHelper\\:\\:mbIsUpper\\(\\) has parameter \\$character with no type specified\\.$#"
count: 1
path: src/PhpSpreadsheet/Shared/StringHelper.php
-
message: "#^Method PhpOffice\\\\PhpSpreadsheet\\\\Shared\\\\StringHelper\\:\\:mbStrSplit\\(\\) has no return type specified\\.$#"
count: 1
path: src/PhpSpreadsheet/Shared/StringHelper.php
-
message: "#^Method PhpOffice\\\\PhpSpreadsheet\\\\Shared\\\\StringHelper\\:\\:mbStrSplit\\(\\) has parameter \\$string with no type specified\\.$#"
count: 1
path: src/PhpSpreadsheet/Shared/StringHelper.php
- -
message: "#^Method PhpOffice\\\\PhpSpreadsheet\\\\Shared\\\\StringHelper\\:\\:sanitizeUTF8\\(\\) should return string but returns string\\|false\\.$#" message: "#^Method PhpOffice\\\\PhpSpreadsheet\\\\Shared\\\\StringHelper\\:\\:sanitizeUTF8\\(\\) should return string but returns string\\|false\\.$#"
count: 1 count: 1
@ -3160,11 +3140,6 @@ parameters:
count: 1 count: 1
path: src/PhpSpreadsheet/Shared/StringHelper.php path: src/PhpSpreadsheet/Shared/StringHelper.php
-
message: "#^Variable \\$textValue on left side of \\?\\? always exists and is not nullable\\.$#"
count: 3
path: src/PhpSpreadsheet/Shared/StringHelper.php
- -
message: "#^Static method PhpOffice\\\\PhpSpreadsheet\\\\Shared\\\\TimeZone\\:\\:validateTimeZone\\(\\) is unused\\.$#" message: "#^Static method PhpOffice\\\\PhpSpreadsheet\\\\Shared\\\\TimeZone\\:\\:validateTimeZone\\(\\) is unused\\.$#"
count: 1 count: 1

2
src/PhpSpreadsheet/Calculation/LookupRef/HLookup.php
View File

@ -73,7 +73,7 @@ class HLookup extends LookupBase
// break if we have passed possible keys // break if we have passed possible keys
$bothNumeric = is_numeric($lookupValue) && is_numeric($rowData); $bothNumeric = is_numeric($lookupValue) && is_numeric($rowData);
$bothNotNumeric = !is_numeric($lookupValue) && !is_numeric($rowData); $bothNotNumeric = !is_numeric($lookupValue) && !is_numeric($rowData);
$cellDataLower = StringHelper::strToLower($rowData); $cellDataLower = StringHelper::strToLower((string) $rowData);
if ( if (
$notExactMatch && $notExactMatch &&

2
src/PhpSpreadsheet/Calculation/LookupRef/VLookup.php
View File

@ -90,7 +90,7 @@ class VLookup extends LookupBase
foreach ($lookupArray as $rowKey => $rowData) { foreach ($lookupArray as $rowKey => $rowData) {
$bothNumeric = is_numeric($lookupValue) && is_numeric($rowData[$column]); $bothNumeric = is_numeric($lookupValue) && is_numeric($rowData[$column]);
$bothNotNumeric = !is_numeric($lookupValue) && !is_numeric($rowData[$column]); $bothNotNumeric = !is_numeric($lookupValue) && !is_numeric($rowData[$column]);
$cellDataLower = StringHelper::strToLower($rowData[$column]); $cellDataLower = StringHelper::strToLower((string) $rowData[$column]);
// break if we have passed possible keys // break if we have passed possible keys
if ( if (

101
src/PhpSpreadsheet/Shared/StringHelper.php
View File

@ -329,12 +329,8 @@ class StringHelper
/** /**
* Try to sanitize UTF8, stripping invalid byte sequences. Not perfect. Does not surrogate characters. * Try to sanitize UTF8, stripping invalid byte sequences. Not perfect. Does not surrogate characters.
*
* @param string $textValue
*
* @return string
*/ */
public static function sanitizeUTF8($textValue) public static function sanitizeUTF8(string $textValue): string
{ {
if (self::getIsIconvEnabled()) { if (self::getIsIconvEnabled()) {
$textValue = @iconv('UTF-8', 'UTF-8', $textValue); $textValue = @iconv('UTF-8', 'UTF-8', $textValue);
@ -349,12 +345,8 @@ class StringHelper
/** /**
* Check if a string contains UTF8 data. * Check if a string contains UTF8 data.
*
* @param string $textValue
*
* @return bool
*/ */
public static function isUTF8($textValue) public static function isUTF8(string $textValue): bool
{ {
return $textValue === '' || preg_match('/^./su', $textValue) === 1; return $textValue === '' || preg_match('/^./su', $textValue) === 1;
} }
@ -364,10 +356,8 @@ class StringHelper
* point as decimal separator in case locale is other than English. * point as decimal separator in case locale is other than English.
* *
* @param mixed $numericValue * @param mixed $numericValue
*
* @return string
*/ */
public static function formatNumber($numericValue) public static function formatNumber($numericValue): string
{ {
if (is_float($numericValue)) { if (is_float($numericValue)) {
return str_replace(',', '.', $numericValue); return str_replace(',', '.', $numericValue);
@ -385,10 +375,8 @@ class StringHelper
* *
* @param string $textValue UTF-8 encoded string * @param string $textValue UTF-8 encoded string
* @param mixed[] $arrcRuns Details of rich text runs in $value * @param mixed[] $arrcRuns Details of rich text runs in $value
*
* @return string
*/ */
public static function UTF8toBIFF8UnicodeShort($textValue, $arrcRuns = []) public static function UTF8toBIFF8UnicodeShort(string $textValue, array $arrcRuns = []): string
{ {
// character count // character count
$ln = self::countCharacters($textValue, 'UTF-8'); $ln = self::countCharacters($textValue, 'UTF-8');
@ -419,10 +407,8 @@ class StringHelper
* see OpenOffice.org's Documentation of the Microsoft Excel File Format, sect. 2.5.3. * see OpenOffice.org's Documentation of the Microsoft Excel File Format, sect. 2.5.3.
* *
* @param string $textValue UTF-8 encoded string * @param string $textValue UTF-8 encoded string
*
* @return string
*/ */
public static function UTF8toBIFF8UnicodeLong($textValue) public static function UTF8toBIFF8UnicodeLong(string $textValue): string
{ {
// character count // character count
$ln = self::countCharacters($textValue, 'UTF-8'); $ln = self::countCharacters($textValue, 'UTF-8');
@ -436,13 +422,10 @@ class StringHelper
/** /**
* Convert string from one encoding to another. * Convert string from one encoding to another.
* *
* @param string $textValue
* @param string $to Encoding to convert to, e.g. 'UTF-8' * @param string $to Encoding to convert to, e.g. 'UTF-8'
* @param string $from Encoding to convert from, e.g. 'UTF-16LE' * @param string $from Encoding to convert from, e.g. 'UTF-16LE'
*
* @return string
*/ */
public static function convertEncoding($textValue, $to, $from) public static function convertEncoding(string $textValue, string $to, string $from): string
{ {
if (self::getIsIconvEnabled()) { if (self::getIsIconvEnabled()) {
$result = iconv($from, $to . self::$iconvOptions, $textValue); $result = iconv($from, $to . self::$iconvOptions, $textValue);
@ -457,52 +440,45 @@ class StringHelper
/** /**
* Get character count. * Get character count.
* *
* @param string $textValue
* @param string $encoding Encoding * @param string $encoding Encoding
* *
* @return int Character count * @return int Character count
*/ */
public static function countCharacters($textValue, $encoding = 'UTF-8') public static function countCharacters(string $textValue, string $encoding = 'UTF-8'): int
{ {
return mb_strlen($textValue ?? '', $encoding); return mb_strlen($textValue, $encoding);
} }
/** /**
* Get a substring of a UTF-8 encoded string. * Get a substring of a UTF-8 encoded string.
* *
* @param null|string $textValue UTF-8 encoded string * @param string $textValue UTF-8 encoded string
* @param int $offset Start offset * @param int $offset Start offset
* @param int $length Maximum number of characters in substring * @param int $length Maximum number of characters in substring
*
* @return string
*/ */
public static function substring($textValue, $offset, $length = 0) public static function substring(string $textValue, int $offset, int $length = 0): string
{ {
return mb_substr($textValue ?? '', $offset, $length, 'UTF-8'); return mb_substr($textValue, $offset, $length, 'UTF-8');
} }
/** /**
* Convert a UTF-8 encoded string to upper case. * Convert a UTF-8 encoded string to upper case.
* *
* @param string $textValue UTF-8 encoded string * @param string $textValue UTF-8 encoded string
*
* @return string
*/ */
public static function strToUpper($textValue) public static function strToUpper(string $textValue): string
{ {
return mb_convert_case($textValue ?? '', MB_CASE_UPPER, 'UTF-8'); return mb_convert_case($textValue, MB_CASE_UPPER, 'UTF-8');
} }
/** /**
* Convert a UTF-8 encoded string to lower case. * Convert a UTF-8 encoded string to lower case.
* *
* @param string $textValue UTF-8 encoded string * @param string $textValue UTF-8 encoded string
*
* @return string
*/ */
public static function strToLower($textValue) public static function strToLower(string $textValue): string
{ {
return mb_convert_case($textValue ?? '', MB_CASE_LOWER, 'UTF-8'); return mb_convert_case($textValue, MB_CASE_LOWER, 'UTF-8');
} }
/** /**
@ -510,24 +486,27 @@ class StringHelper
* (uppercase every first character in each word, lower case all other characters). * (uppercase every first character in each word, lower case all other characters).
* *
* @param string $textValue UTF-8 encoded string * @param string $textValue UTF-8 encoded string
*
* @return string
*/ */
public static function strToTitle($textValue) public static function strToTitle(string $textValue): string
{ {
return mb_convert_case($textValue, MB_CASE_TITLE, 'UTF-8'); return mb_convert_case($textValue, MB_CASE_TITLE, 'UTF-8');
} }
public static function mbIsUpper($character) public static function mbIsUpper(string $character): bool
{ {
return mb_strtolower($character, 'UTF-8') != $character; return mb_strtolower($character, 'UTF-8') !== $character;
} }
public static function mbStrSplit($string) /**
* Splits a UTF-8 string into an array of individual characters.
*/
public static function mbStrSplit(string $string): array
{ {
// Split at all position not after the start: ^ // Split at all position not after the start: ^
// and not before the end: $ // and not before the end: $
return preg_split('/(?<!^)(?!$)/u', $string); $split = preg_split('/(?<!^)(?!$)/u', $string);
return ($split === false) ? [] : $split;
} }
/** /**
@ -535,10 +514,8 @@ class StringHelper
* and all lowercase characters become uppercase. * and all lowercase characters become uppercase.
* *
* @param string $textValue UTF-8 encoded string * @param string $textValue UTF-8 encoded string
*
* @return string
*/ */
public static function strCaseReverse($textValue) public static function strCaseReverse(string $textValue): string
{ {
$characters = self::mbStrSplit($textValue); $characters = self::mbStrSplit($textValue);
foreach ($characters as &$character) { foreach ($characters as &$character) {
@ -557,10 +534,8 @@ class StringHelper
* and convert it to a numeric if it is. * and convert it to a numeric if it is.
* *
* @param string $operand string value to test * @param string $operand string value to test
*
* @return bool
*/ */
public static function convertToNumberIfFraction(&$operand) public static function convertToNumberIfFraction(string &$operand): bool
{ {
if (preg_match('/^' . self::STRING_REGEXP_FRACTION . '$/i', $operand, $match)) { if (preg_match('/^' . self::STRING_REGEXP_FRACTION . '$/i', $operand, $match)) {
$sign = ($match[1] == '-') ? '-' : '+'; $sign = ($match[1] == '-') ? '-' : '+';
@ -578,10 +553,8 @@ class StringHelper
/** /**
* Get the decimal separator. If it has not yet been set explicitly, try to obtain number * Get the decimal separator. If it has not yet been set explicitly, try to obtain number
* formatting information from locale. * formatting information from locale.
*
* @return string
*/ */
public static function getDecimalSeparator() public static function getDecimalSeparator(): string
{ {
if (!isset(self::$decimalSeparator)) { if (!isset(self::$decimalSeparator)) {
$localeconv = localeconv(); $localeconv = localeconv();
@ -603,7 +576,7 @@ class StringHelper
* *
* @param string $separator Character for decimal separator * @param string $separator Character for decimal separator
*/ */
public static function setDecimalSeparator($separator): void public static function setDecimalSeparator(string $separator): void
{ {
self::$decimalSeparator = $separator; self::$decimalSeparator = $separator;
} }
@ -611,10 +584,8 @@ class StringHelper
/** /**
* Get the thousands separator. If it has not yet been set explicitly, try to obtain number * Get the thousands separator. If it has not yet been set explicitly, try to obtain number
* formatting information from locale. * formatting information from locale.
*
* @return string
*/ */
public static function getThousandsSeparator() public static function getThousandsSeparator(): string
{ {
if (!isset(self::$thousandsSeparator)) { if (!isset(self::$thousandsSeparator)) {
$localeconv = localeconv(); $localeconv = localeconv();
@ -636,7 +607,7 @@ class StringHelper
* *
* @param string $separator Character for thousands separator * @param string $separator Character for thousands separator
*/ */
public static function setThousandsSeparator($separator): void public static function setThousandsSeparator(string $separator): void
{ {
self::$thousandsSeparator = $separator; self::$thousandsSeparator = $separator;
} }
@ -644,10 +615,8 @@ class StringHelper
/** /**
* Get the currency code. If it has not yet been set explicitly, try to obtain the * Get the currency code. If it has not yet been set explicitly, try to obtain the
* symbol information from locale. * symbol information from locale.
*
* @return string
*/ */
public static function getCurrencyCode() public static function getCurrencyCode(): string
{ {
if (!empty(self::$currencyCode)) { if (!empty(self::$currencyCode)) {
return self::$currencyCode; return self::$currencyCode;
@ -674,7 +643,7 @@ class StringHelper
* *
* @param string $currencyCode Character for currency code * @param string $currencyCode Character for currency code
*/ */
public static function setCurrencyCode($currencyCode): void public static function setCurrencyCode(string $currencyCode): void
{ {
self::$currencyCode = $currencyCode; self::$currencyCode = $currencyCode;
} }
@ -682,11 +651,11 @@ class StringHelper
/** /**
* Convert SYLK encoded string to UTF-8. * Convert SYLK encoded string to UTF-8.
* *
* @param string $textValue * @param string $textValue SYLK encoded string
* *
* @return string UTF-8 encoded string * @return string UTF-8 encoded string
*/ */
public static function SYLKtoUTF8($textValue) public static function SYLKtoUTF8(string $textValue): string
{ {
self::buildCharacterSets(); self::buildCharacterSets();