php/doc-zh

Chinese translation of the PHP documentation

doc-zh's Issues

属性的访问控制页面中执行结果展示错误

From manual page: https://php.net/language.oop5.visibility

---属性的访问控制
MyClass2类继承MyClass时,在MyClass2类中修改public和protected属性,对应属性会发生变化,但是手册上的打印结果时错的

$obj2->printHello(); // 输出 Public、Protected2 和 Undefined

输出结果应该是 Public2

spl_autoload_register 中文翻译 typo

From manual page: https://php.net/function.spl-autoload-register

---

错误
它有效的创建了自动加载函数队列，病按定义的顺序进行遍历。

正确
它有效的创建了自动加载函数队列，并按定义的顺序进行遍历。

翻译错误

From manual page: https://php.net/function.defined

---

原文：
此函数也可以跟累常量和 enum cases 一起工作。

正确为：
此函数也可以跟类常量和 enum cases 一起工作。

$matches前多了一个字符。

From manual page: https://php.net/function.preg-match-all

---

$matches前多了一个字符。

The two languages display different content

From manual page: https://php.net/filters.convert

---

https://www.php.net/manual/en/filters.convert.php
https://www.php.net/manual/zh/filters.convert.php

The description of convert.iconv.* is missing in Chinese

示例9中文翻译有误

From manual page: https://php.net/language.namespaces.faq

---示例 #9 在双引号字符串中使用命名空间的危险性

使用telnet协议，$match全是null的

From manual page: https://www.php.net/manual/zh/expect.examples-usage.php

---

Using the telnet protocol test, $match variable has always been null.

a word spell wrong

From manual page: https://php.net/language.enumerations.static-methods

---

"仅管“ ===》 ”尽管“？

ksort sorting is inconsistent

From manual page: https://php.net/function.ksort

---

php7

$data = [ "user_id" => 1, "0"=>1 ]; 
ksort($data);
var_dump($data);

result:

array(2) {
  'user_id' =>int(1)
  [0] =>int(1)
}

php8:

$data = [ "user_id" => 1, "0"=>1 ]; 
ksort($data);
var_dump($data);

result:

array(2) {
  [0] =>int(1)
  'user_id' => int(1)
}

更新日志描述错字

From manual page: https://php.net/function.pack

---

float 和 double 类型支持打断和小端。

url：https://www.php.net/manual/zh/function.pack.php

是否应为 大端和小端

example function importer issue

From manual page: https://php.net/generator.send

---

Example (note the handling of null, which you would send to the generator to handle stragglers after the previous batch)

function importer()
{
  $max = 500;
  $items = [];
  while (true) {
    $item = yield;
    if ($item !== null) {
      $items[] = yield;  //$item instead of yield,otherwise the $items will always have one item
    }
    if ($item === null || count($items) >= $max) {
       // do batch operations
       $items = [];
    }
  }
}

The offline version of PHP user manual downloaded is unusable.

From manual page: https://www.php.net/download-docs.php

---

I would like to ask why the offline version of PHP user manual downloaded is blank when opened in Win10 environment.

Is there a Mac OS Monterey version of PHP? How to install it

From manual page: https://php.net/install.macosx.bundled

---

中文版本下有字错误 “仅管 enum 可以包括 public、private、protected 的方法”

From manual page: https://php.net/language.enumerations.methods
枚举方法导航下：“仅管 enum 可以包括 public、private、protected 的方法”，应该是“尽管”。

bugbugbugbug

From manual page: https://php.net/function.call-user-func-array

---Uncaught Error: Cannot use positional argument after named argument
8之前的版本都是正常的，call_user_func_array 一个callback，一个array，哪来的positional argument！你们眼瞎还是心瞎了？乱改锤子呢！休你仙人了！**

the item "serialize_precision" is now default 17 not -1; Prior to PHP 7.1.0, the default value was -1.

From manual page: https://php.net/ini.core

---

a small translation mistake

From manual page: https://php.net/language.oop5.basic
language:Chinese(Simplified)

Calling a non-static method statically throws an Error. 翻译成了以静态方式去调用一个静态方法
应该改成 :以静态方式去调用一个非静态方法

---

未定义和 unset() 的变量豆浆解析为值 null。

From manual page: https://php.net/language.types.null

---

未定义和 unset() 的变量豆浆解析为值 null。
豆浆应该为都将吧

openssl_pkey_get_details 未知类型返回值说明错误

From manual page: https://php.net/function.openssl-pkey-get-details

---

中文文档 :
type (如下密钥类型之一： OPENSSL_KEYTYPE_RSA, OPENSSL_KEYTYPE_DSA, OPENSSL_KEYTYPE_DH, OPENSSL_KEYTYPE_EC 或者 未知类型返回1)

英语文档:
type (type of the key which is one of OPENSSL_KEYTYPE_RSA, OPENSSL_KEYTYPE_DSA, OPENSSL_KEYTYPE_DH, OPENSSL_KEYTYPE_EC or -1 meaning unknown).

更正：
未知类型返回1 => 未知类型返回 -1

未翻译php8 str-新增函数

From manual page: https://php.net/function.str-ends-with
From manual page: https://www.php.net/manual/zh/function.str-starts-with.php

When the value is negative, the return value is incorrect

From manual page: https://php.net/pdo.lastinsertid

When the return value should be -1,
but 18446744073709551615 is returned
only in php8.1

trait代码复用机制问题

From manual page: https://php.net/language.oop5.traits
trait代码复用机制问题

代码正常

<?php

class A
{
    protected static $instance = null;

    public static function getInstance(...$args)
    {
        if(!isset(self::$instance)){
            self::$instance = new static(...$args);
        }
        return self::$instance;
    }

    public function getB()
    {
        return B::class::getInstance();
    }
}

class B extends A
{
    protected static $instance = null;

    public static function getInstance(...$args)
    {
        if(!isset(self::$instance)){
            self::$instance = new static(...$args);
        }
        return self::$instance;
    }
}
var_dump(A::getInstance()->getB()); // B

代码复用不正常

<?php

trait Singleton
{
    protected static $instance = null;

    public static function getInstance(...$args)
    {
        if(!isset(self::$instance)){
            self::$instance = new static(...$args);
        }
        return self::$instance;
    }
}

class A
{
    use Singleton;

    public function getB()
    {
        return B::class::getInstance();
    }
}

class B extends A
{
    use Singleton;
}
var_dump(A::getInstance()->getB()); // A

CGI 版本的文件名为 php-cli.exe。错误

From manual page: https://php.net/features.commandline.introduction

---

CGI 版本的文件名为 php-cli.exe。应该修改为：CGI 版本的文件名为 php-cgi.exe。

函数is_object中文翻译不准确

From manual page: https://php.net/function.is-object

---

当前的翻译内容是"is_object — 查找变量是否是字符串"，翻译应该是"is_object — 查找变量是否是对象"。

英文文档更新了，但是待翻译文档列表中并没有出现该文档

比如该文件的更新历史：

https://github.com/php/doc-en/commits/master/appendices/migration80/other-changes.xml

已经有4次更新。但是中文版的地址commit却是英文的版本的第一次的 commit 。按照这个情况来说，待翻译文档应该会提示该文档后续有更新。应该进行提示才对呀。

难道说这个只能提示中文没有翻译的吗？😓

options 和 longopts 应为 short_options 和 long_options

From manual page: https://php.net/function.getopt

原文:

Note:
The format for the short_options and long_options is almost the same, the only difference is that long_options takes an array of options (where each element is the option) whereas short_options takes a string (where each character is the option).

中文 (当前):

注意:
options 和 longopts 的格式几乎是一样的，唯一的不同之处是 longopts 需要是选项的数组（每个元素为一个选项），而 options 需要一个字符串（每个字符是个选项）。

options 和 longopts 应为 short_options 和 long_options

php8+ with-curl option didn`t work

From manual page: https://php.net/curl.installation

---

specified curl-dir , still make default dir.

the Makefile CURL_SHARED_LIBADD is empty
CURL_SHARED_LIBADD =

after make

the CURL is still old version

并且有许多的 IP 地址讲导致在 32 位系统的情况下为负数

From manual page: https://php.net/function.ip2long

---

并且有许多的 IP 地址将导致在 32 位系统的情况下为负数
讲应为将

The fifth and second parameters have the same name

From manual page: https://php.net/function.odbc-foreignkeys

--- The fifth and second parameters have the same name，the fifth parameter is fk_catalog or not ?

Chinese(Simplified) Translation Error.

From manual page: https://php.net/function.settype

---

注意:

“int”的最小值是 [PHP_INT_MAX]

=>
“int”的最大值是 [PHP_INT_MAX]

大海捞针，在大海（haystack）中搜索针（ needle）

From manual page: https://php.net/function.in-array

---

这句还是翻译成，比较合适：
大海捞针，在干草堆（haystack）中搜索针（ needle）

Document Missing

Why is there no complete instructions for this function? What modules can I set and how to use it？

From manual page: https://php.net/function.session-module-name

---

从官网中下载下来的chm文件类似渲染缺失

之前下载的chm帮助文件有明显的蓝色主题，但是现在变成了纯白，请问是我设置的有问题还是类似渲染缺失？

在php.ini中设置了拓展路径，也打开了拓展，php_musqli.dll文件也在ext文件夹下，web服务器也进行了重启，为什么还是无法安装mysqli拓展

From manual page: https://php.net/mysqli.installation

---

Reflector should be interface instead of class

From manual page: https://php.net/class.reflector

预定义常量PHP_INT_MIN 说明错误

From manual page: https://php.net/reserved.constants

---

PHP_INT_MIN应该为：当前 PHP 版本支持的最小整型数字

doc and php runtime error

From manual page: https://php.net/functions.arguments

---

php-src in /ext/standard/basic_functions.stub.php line 132

the second name is count, but php runtime and doc is num.

php-src:
function array_fill(int $start_index, int $count, mixed $value): array {}

doc-zh:

<?php
array_fill(value: 50, num: 100, start_index: 0);
?>

touch时间戳问题

From manual page: https://php.net/function.touch

touch在win10环境下，先复制文件后，修改文件最后修改日期，结果修改后文件的实际时间戳多1秒。这个问题是在文件同步到U盘的情况下出现的，在系统磁盘之间无问题。

$dfile ='D:\touch_test\100.txt';
$efile ='E:\upan_disk\100.txt';

$dfile =str_replace('\', '/', $dfile);
$efile =str_replace('\', '/', $efile);

$mt_from =filemtime($dfile);

var_dump( 'dfile: '. $mt_from );
var_dump( 'efile: '. filemtime($efile) );

$stat =copy($dfile, $efile);
var_dump( $stat );

$stat =touch($efile, $mt_from);
var_dump( $stat );

但该函数扔可能会终止。

From manual page: https://php.net/language.types.void

---

但该函数扔可能会终止。
扔应为仍

Why can't the redis password set in session_path in php.ini have the + sign?

I am using php7.4 version
session.save_path="tcp://127.0.0.1:6379?auth=wxdefa+6uysfs"
There is a + sign in the password, and the session will be invalid if the session is saved