diff --git a/reference/fileinfo/functions/finfo-close.xml b/reference/fileinfo/functions/finfo-close.xml index fbfd12f4b..65eb103b7 100644 --- a/reference/fileinfo/functions/finfo-close.xml +++ b/reference/fileinfo/functions/finfo-close.xml @@ -1,6 +1,6 @@ - + @@ -20,7 +20,9 @@ - 关闭 finfo_open 函数所返回的 fileinfo 实例。 + 此函数用于关闭由 finfo_open 打开的实例,直到 PHP 7.4, + 但自 PHP 8.0 以来,由于 finfo 资源到对象的转换, + 此函数已成为无操作,并且在 PHP 8.5 中已被弃用。 diff --git a/reference/ftp/functions/ftp-set-option.xml b/reference/ftp/functions/ftp-set-option.xml index 1b9209f5d..7f56fe829 100644 --- a/reference/ftp/functions/ftp-set-option.xml +++ b/reference/ftp/functions/ftp-set-option.xml @@ -1,6 +1,6 @@ - + @@ -77,6 +77,7 @@ + &reftitle.returnvalues; @@ -84,6 +85,15 @@ + + &reftitle.errors; + + 如果 option 不受支持,则会抛出一个 ValueError。 + 如果传递的 value 与给定 option 的预期类型不匹配, + 则会抛出一个 TypeError。 + + + &reftitle.changelog; diff --git a/reference/image/functions/getimagesize.xml b/reference/image/functions/getimagesize.xml index db6a8d9ce..739055655 100644 --- a/reference/image/functions/getimagesize.xml +++ b/reference/image/functions/getimagesize.xml @@ -1,6 +1,6 @@ - + @@ -149,6 +149,10 @@ if ($size && $fp) { 如果无法访问 filename 图像,getimagesize 将生成 E_WARNING 级别的错误。读取错误时,getimagesize 将生成 E_NOTICE 级别的错误。 + + 从 PHP 8.0.0 开始,如果 filename 不存在或无法访问, + 将抛出一个 ValueError。 + @@ -169,6 +173,14 @@ if ($size && $fp) { 现在将正确返回 AVIF 图像的实际尺寸、bits 和 channels;以前,尺寸报告为 0x0,并且不会报告 bits 和 channels。 + + 8.0.0 + + 如果 filename 不存在或无法访问,将抛出一个 + ValueError;之前会生成一个 E_WARNING + 级别的错误,并且函数返回 &false;。 + + 7.1.0 diff --git a/reference/image/functions/imagealphablending.xml b/reference/image/functions/imagealphablending.xml index 62eaa1344..c695b52a4 100644 --- a/reference/image/functions/imagealphablending.xml +++ b/reference/image/functions/imagealphablending.xml @@ -1,7 +1,7 @@ - - + + imagealphablending @@ -10,7 +10,7 @@ &reftitle.description; - boolimagealphablending + trueimagealphablending GdImageimage boolenable @@ -43,7 +43,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imageantialias.xml b/reference/image/functions/imageantialias.xml index 7162c8476..fc5fe9788 100644 --- a/reference/image/functions/imageantialias.xml +++ b/reference/image/functions/imageantialias.xml @@ -1,7 +1,7 @@ - - + + imageantialias @@ -10,7 +10,7 @@ &reftitle.description; - boolimageantialias + trueimageantialias GdImageimage boolenable @@ -45,7 +45,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagearc.xml b/reference/image/functions/imagearc.xml index 7364b5d9a..7def04c49 100644 --- a/reference/image/functions/imagearc.xml +++ b/reference/image/functions/imagearc.xml @@ -1,7 +1,7 @@ - - + + imagearc @@ -10,7 +10,7 @@ &reftitle.description; - boolimagearc + trueimagearc GdImageimage intcenter_x intcenter_y @@ -91,7 +91,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagechar.xml b/reference/image/functions/imagechar.xml index 25a4a1dc1..d369f11eb 100644 --- a/reference/image/functions/imagechar.xml +++ b/reference/image/functions/imagechar.xml @@ -1,7 +1,7 @@ - - + + imagechar @@ -10,7 +10,7 @@ &reftitle.description; - boolimagechar + trueimagechar GdImageimage GdFontintfont intx @@ -68,7 +68,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagecharup.xml b/reference/image/functions/imagecharup.xml index f017a22ca..b2f504752 100644 --- a/reference/image/functions/imagecharup.xml +++ b/reference/image/functions/imagecharup.xml @@ -1,7 +1,7 @@ - - + + imagecharup @@ -10,7 +10,7 @@ &reftitle.description; - boolimagecharup + trueimagecharup GdImageimage GdFontintfont intx @@ -66,7 +66,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagecolordeallocate.xml b/reference/image/functions/imagecolordeallocate.xml index ca227e4dc..b6f002fb3 100644 --- a/reference/image/functions/imagecolordeallocate.xml +++ b/reference/image/functions/imagecolordeallocate.xml @@ -1,7 +1,7 @@ - - + + imagecolordeallocate @@ -10,7 +10,7 @@ &reftitle.description; - boolimagecolordeallocate + trueimagecolordeallocate GdImageimage intcolor @@ -38,7 +38,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagecolormatch.xml b/reference/image/functions/imagecolormatch.xml index e63eb68ae..dea4b59e4 100644 --- a/reference/image/functions/imagecolormatch.xml +++ b/reference/image/functions/imagecolormatch.xml @@ -1,7 +1,7 @@ - - + + imagecolormatch @@ -10,7 +10,7 @@ &reftitle.description; - boolimagecolormatch + trueimagecolormatch GdImageimage1 GdImageimage2 @@ -44,7 +44,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagecopy.xml b/reference/image/functions/imagecopy.xml index 9f0ea9341..09ec995d7 100644 --- a/reference/image/functions/imagecopy.xml +++ b/reference/image/functions/imagecopy.xml @@ -1,7 +1,7 @@ - - + + imagecopy @@ -10,7 +10,7 @@ &reftitle.description; - boolimagecopy + trueimagecopy GdImagedst_image GdImagesrc_image intdst_x @@ -93,7 +93,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagecopymerge.xml b/reference/image/functions/imagecopymerge.xml index a7fefd4c5..d29c13956 100644 --- a/reference/image/functions/imagecopymerge.xml +++ b/reference/image/functions/imagecopymerge.xml @@ -1,7 +1,7 @@ - - + + imagecopymerge @@ -10,7 +10,7 @@ &reftitle.description; - boolimagecopymerge + trueimagecopymerge GdImagedst_image GdImagesrc_image intdst_x @@ -103,7 +103,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagecopymergegray.xml b/reference/image/functions/imagecopymergegray.xml index 3620d99ae..f142a4fe6 100644 --- a/reference/image/functions/imagecopymergegray.xml +++ b/reference/image/functions/imagecopymergegray.xml @@ -1,7 +1,7 @@ - - + + imagecopymergegray @@ -10,7 +10,7 @@ &reftitle.description; - boolimagecopymergegray + trueimagecopymergegray GdImagedst_image GdImagesrc_image intdst_x @@ -105,7 +105,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagecopyresampled.xml b/reference/image/functions/imagecopyresampled.xml index 9da9fce20..0959ab42c 100644 --- a/reference/image/functions/imagecopyresampled.xml +++ b/reference/image/functions/imagecopyresampled.xml @@ -1,7 +1,7 @@ - - + + imagecopyresampled @@ -10,7 +10,7 @@ &reftitle.description; - boolimagecopyresampled + trueimagecopyresampled GdImagedst_image GdImagesrc_image intdst_x @@ -121,7 +121,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagecopyresized.xml b/reference/image/functions/imagecopyresized.xml index a810bdba8..147ead6fb 100644 --- a/reference/image/functions/imagecopyresized.xml +++ b/reference/image/functions/imagecopyresized.xml @@ -1,7 +1,7 @@ - - + + imagecopyresized @@ -10,7 +10,7 @@ &reftitle.description; - boolimagecopyresized + trueimagecopyresized GdImagedst_image GdImagesrc_image intdst_x @@ -123,7 +123,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagedashedline.xml b/reference/image/functions/imagedashedline.xml index 1549b6703..90ee25722 100644 --- a/reference/image/functions/imagedashedline.xml +++ b/reference/image/functions/imagedashedline.xml @@ -1,7 +1,7 @@ - - + + imagedashedline @@ -10,7 +10,7 @@ &reftitle.description; - boolimagedashedline + trueimagedashedline GdImageimage intx1 inty1 @@ -73,7 +73,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagedestroy.xml b/reference/image/functions/imagedestroy.xml index 2790936ae..1eb2ae752 100644 --- a/reference/image/functions/imagedestroy.xml +++ b/reference/image/functions/imagedestroy.xml @@ -1,6 +1,6 @@ - + @@ -14,7 +14,7 @@ &reftitle.description; #[\Deprecated] - boolimagedestroy + trueimagedestroy GdImageimage ¬e.resource-migration-8.0-dead-function; @@ -34,7 +34,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imageellipse.xml b/reference/image/functions/imageellipse.xml index 0a46036a1..22dee61c2 100644 --- a/reference/image/functions/imageellipse.xml +++ b/reference/image/functions/imageellipse.xml @@ -1,7 +1,7 @@ - - + + imageellipse @@ -10,7 +10,7 @@ &reftitle.description; - boolimageellipse + trueimageellipse GdImageimage intcenter_x intcenter_y @@ -73,7 +73,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagefill.xml b/reference/image/functions/imagefill.xml index 811020fce..84ea5bdd8 100644 --- a/reference/image/functions/imagefill.xml +++ b/reference/image/functions/imagefill.xml @@ -1,7 +1,7 @@ - - + + imagefill @@ -10,7 +10,7 @@ &reftitle.description; - boolimagefill + trueimagefill GdImageimage intx inty @@ -55,7 +55,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagefilledarc.xml b/reference/image/functions/imagefilledarc.xml index aa42cd22e..d228167e3 100644 --- a/reference/image/functions/imagefilledarc.xml +++ b/reference/image/functions/imagefilledarc.xml @@ -1,7 +1,7 @@ - - + + imagefilledarc @@ -10,7 +10,7 @@ &reftitle.description; - boolimagefilledarc + trueimagefilledarc GdImageimage intcenter_x intcenter_y @@ -113,7 +113,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagefilledellipse.xml b/reference/image/functions/imagefilledellipse.xml index 81a5343df..a9751a28c 100644 --- a/reference/image/functions/imagefilledellipse.xml +++ b/reference/image/functions/imagefilledellipse.xml @@ -1,7 +1,7 @@ - - + + imagefilledellipse @@ -10,7 +10,7 @@ &reftitle.description; - boolimagefilledellipse + trueimagefilledellipse GdImageimage intcenter_x intcenter_y @@ -73,7 +73,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagefilledrectangle.xml b/reference/image/functions/imagefilledrectangle.xml index e75178e94..d8a8158bc 100644 --- a/reference/image/functions/imagefilledrectangle.xml +++ b/reference/image/functions/imagefilledrectangle.xml @@ -1,7 +1,7 @@ - - + + imagefilledrectangle @@ -10,7 +10,7 @@ &reftitle.description; - boolimagefilledrectangle + trueimagefilledrectangle GdImageimage intx1 inty1 @@ -74,7 +74,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagefilltoborder.xml b/reference/image/functions/imagefilltoborder.xml index 50ffbcbde..ca95f1132 100644 --- a/reference/image/functions/imagefilltoborder.xml +++ b/reference/image/functions/imagefilltoborder.xml @@ -1,7 +1,7 @@ - - + + imagefilltoborder @@ -10,7 +10,7 @@ &reftitle.description; - boolimagefilltoborder + trueimagefilltoborder GdImageimage intx inty @@ -66,7 +66,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagegammacorrect.xml b/reference/image/functions/imagegammacorrect.xml index 7cb813c56..456e164cc 100644 --- a/reference/image/functions/imagegammacorrect.xml +++ b/reference/image/functions/imagegammacorrect.xml @@ -1,7 +1,7 @@ - - + + imagegammacorrect @@ -10,7 +10,7 @@ &reftitle.description; - boolimagegammacorrect + trueimagegammacorrect GdImageimage floatinput_gamma floatoutput_gamma @@ -46,7 +46,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagelayereffect.xml b/reference/image/functions/imagelayereffect.xml index 16bf75512..2f99bf114 100755 --- a/reference/image/functions/imagelayereffect.xml +++ b/reference/image/functions/imagelayereffect.xml @@ -1,7 +1,7 @@ - - + + imagelayereffect @@ -10,7 +10,7 @@ &reftitle.description; - boolimagelayereffect + trueimagelayereffect GdImageimage inteffect @@ -79,7 +79,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imageline.xml b/reference/image/functions/imageline.xml index c6b625dd0..11aa8980a 100644 --- a/reference/image/functions/imageline.xml +++ b/reference/image/functions/imageline.xml @@ -1,7 +1,7 @@ - - + + imageline @@ -10,7 +10,7 @@ &reftitle.description; - boolimageline + trueimageline GdImageimage intx1 inty1 @@ -73,7 +73,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagerectangle.xml b/reference/image/functions/imagerectangle.xml index 9a181eb22..6bdbe871d 100644 --- a/reference/image/functions/imagerectangle.xml +++ b/reference/image/functions/imagerectangle.xml @@ -1,7 +1,7 @@ - - + + imagerectangle @@ -10,7 +10,7 @@ &reftitle.description; - boolimagerectangle + trueimagerectangle GdImageimage intx1 inty1 @@ -74,7 +74,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagesavealpha.xml b/reference/image/functions/imagesavealpha.xml index 91227291c..89eed8083 100644 --- a/reference/image/functions/imagesavealpha.xml +++ b/reference/image/functions/imagesavealpha.xml @@ -1,7 +1,7 @@ - - + + imagesavealpha @@ -11,7 +11,7 @@ &reftitle.description; - boolimagesavealpha + trueimagesavealpha GdImageimage boolenable @@ -51,7 +51,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagesetbrush.xml b/reference/image/functions/imagesetbrush.xml index 20d68d7a8..c2b429fcb 100644 --- a/reference/image/functions/imagesetbrush.xml +++ b/reference/image/functions/imagesetbrush.xml @@ -1,7 +1,7 @@ - - + + imagesetbrush @@ -10,7 +10,7 @@ &reftitle.description; - boolimagesetbrush + trueimagesetbrush GdImageimage GdImagebrush @@ -47,7 +47,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagesetpixel.xml b/reference/image/functions/imagesetpixel.xml index de4bec2c5..c73738231 100644 --- a/reference/image/functions/imagesetpixel.xml +++ b/reference/image/functions/imagesetpixel.xml @@ -1,6 +1,6 @@ - + @@ -10,7 +10,7 @@ &reftitle.description; - boolimagesetpixel + trueimagesetpixel GdImageimage intx inty @@ -55,7 +55,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagesetthickness.xml b/reference/image/functions/imagesetthickness.xml index 8bef763ee..a98ced252 100644 --- a/reference/image/functions/imagesetthickness.xml +++ b/reference/image/functions/imagesetthickness.xml @@ -1,7 +1,7 @@ - - + + imagesetthickness @@ -10,7 +10,7 @@ &reftitle.description; - boolimagesetthickness + trueimagesetthickness GdImageimage intthickness @@ -38,7 +38,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagesettile.xml b/reference/image/functions/imagesettile.xml index 82a7e0fe3..575fd0a4c 100644 --- a/reference/image/functions/imagesettile.xml +++ b/reference/image/functions/imagesettile.xml @@ -1,7 +1,7 @@ - - + + imagesettile @@ -10,7 +10,7 @@ &reftitle.description; - boolimagesettile + trueimagesettile GdImageimage GdImagetile @@ -49,7 +49,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagestring.xml b/reference/image/functions/imagestring.xml index c79f01343..4c5335f2a 100644 --- a/reference/image/functions/imagestring.xml +++ b/reference/image/functions/imagestring.xml @@ -1,7 +1,7 @@ - - + + imagestring @@ -10,7 +10,7 @@ &reftitle.description; - boolimagestring + trueimagestring GdImageimage GdFontintfont intx @@ -66,7 +66,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/image/functions/imagestringup.xml b/reference/image/functions/imagestringup.xml index 48769a5cc..d98f55b53 100644 --- a/reference/image/functions/imagestringup.xml +++ b/reference/image/functions/imagestringup.xml @@ -1,7 +1,7 @@ - - + + imagestringup @@ -10,7 +10,7 @@ &reftitle.description; - boolimagestringup + trueimagestringup GdImageimage GdFontintfont intx @@ -66,7 +66,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; diff --git a/reference/pcntl/functions/pcntl-exec.xml b/reference/pcntl/functions/pcntl-exec.xml index 4ab35854c..9b85000ae 100644 --- a/reference/pcntl/functions/pcntl-exec.xml +++ b/reference/pcntl/functions/pcntl-exec.xml @@ -1,6 +1,7 @@ - + + pcntl_exec @@ -10,7 +11,7 @@ &reftitle.description; - boolpcntl_exec + falsepcntl_exec stringpath arrayargs[] arrayenv_vars[] @@ -47,7 +48,7 @@ env_vars 是一个要传递给程序作为环境变量的字符串数组。这个数组是 - key => value 格式的,key 代表要传递的环境变量的名称,value 代表该环境变量值。 + key => value 格式的,key 代表要传递的环境变量的名称,value 代表该环境变量值。