socket_accept: wrong statements about socket_set_blocking, false and socket_last_error
Maintainer thường phản hồi trong vòng 1 ngày
Đánh giá
- Độ khó
- 1/5
- Thời gian dự kiến
- 1-3 giờ
- Mức phù hợp với người mới
- 89/100
- Loại issue
- Tài liệu
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- php
- Lĩnh vực
- documentation
Hướng nghiên cứu
Bắt đầu với trang hướng dẫn socket-accept và trang ví dụ về sockets được đề cập trong issue. Cập nhật lệnh gọi chặn, giải thích rằng false nghĩa là không có kết nối nào đang chờ và dùng socket_last_error() không có đối số ở cả hai nơi. Hoàn tất khi cả hai trang đều thể hiện những chỉnh sửa này.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Affected page
https://www.php.net/manual/en/function.socket-accept.php
Issue description
socket_set_blocking()doesn't work on aSocket(it is an alias ofstream_set_blocking()); onlysocket_set_nonblock()does.falseis returned only when no connection is pending (EAGAIN), without a warning.socket_last_error()gives the error only without argument: after a failed accept,socket_last_error($listener)returns 0. The example in the sockets examples page does exactly that.
Steps to reproduce
$l = socket_create(AF_INET, SOCK_STREAM, 0);
socket_set_blocking($l, false);
// TypeError: Argument #1 ($stream) must be of type resource, Socket given
Suggested fix
Mention socket_set_nonblock() instead, say false means no pending connection, and call socket_last_error() without argument (in the page and in the example).
- Ngôn ngữ chính
- XML
- Star
- 600
- Fork
- 903
- Merge trung bình
- 1 ngày 7 giờ
- Pull request đã merge (30 ngày)
- 76
Chuẩn bị môi trường
Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.
- Không có Dockerfile hay tệp Docker Compose
- Không có mẫu pull request
- Không có hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của php/doc-en
-
session_write_close: the return value is not success or failureCó thể đã có người làm @qodelicious đã nhận hôm nay. Đang mởbug good first issue
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 91/100
Maintainer thường phản hồi trong vòng 1 ngày
-
enhancement
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
Maintainer thường phản hồi trong vòng 1 ngày
-
SID is deprecatedCó thể đã có người làm @jordikroon đã nhận 7 ngày trước. Đang mởbug
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 88/100
php/doc-en#5937 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
enchant_dict_*: document the ValueError and fix the return valuesCó thể đã có người làm @qodelicious đã nhận 1 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
Maintainer thường phản hồi trong vòng 1 ngày
-
enhancement
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
Maintainer thường phản hồi trong vòng 1 ngày
Issue tương tự
-
sync-en
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
Maintainer thường phản hồi trong vòng 3 ngày
-
documentation hermes-queue
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
chrisalunlloyd2-sudo/mindpalace#294 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Refresh stale docsĐang mở
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 67/100
OpenCarControls/firmware#35 ·
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 73/100
-
[integration]: DefrrĐang mởexternal integration integration-submission
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
langchain-ai/docs#6950 ·
Maintainer thường phản hồi trong vòng 1 ngày