Skip to content
3 changes: 2 additions & 1 deletion public/releases/8.6/common.php
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,8 @@
'fr' => 'Français',
'it' => 'Italiano',
'pt_BR' => 'Brazilian Portuguese',
'ja' => '日本語'
'ja' => '日本語',
'vi' => "Tiếng Việt"
];

function common_header(string $description): void {
Expand Down
79 changes: 79 additions & 0 deletions public/releases/8.6/languages/vi.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@
<?php

return [
'common_header' => 'PHP 8.6 là một bản cập nhật quan trọng của ngôn ngữ lập trình PHP, với nhiều tính năng mới bao gồm Áp dụng Hàm từng phần, lớp Duration mới, Polling API và hàm clamp() mới.',
'main_title' => 'Nhanh hơn, An toàn hơn, Mạnh mẽ hơn',
'main_subtitle' => '<p><strong>PHP 8.6 là một bản cập nhật quan trọng của ngôn ngữ lập trình PHP</strong>, với nhiều tính năng mới bao gồm <strong>Áp dụng Hàm từng phần</strong>, lớp <strong>Duration</strong> mới, <strong>Polling API</strong> và hàm <strong>clamp()</strong> mới.',

'whats_new' => 'Có gì mới trong phiên bản 8.6',
'upgrade_now' => 'Cập nhật lên PHP 8.6',
'old_version' => 'PHP 8.5 và cũ hơn',
'badge_new' => 'MỚI',
'documentation' => 'Tài liệu',
'released' => 'Phát hành ngày 19 tháng 11 năm 2026',
'release_unavailable_reason' => 'PHP 8.6 chưa được phát hành. Nó sẽ được phát hành ngày 19 tháng 11 năm 2026',
'key_features' => 'Những tính năng quan trọng trong PHP 8.6',
'key_features_description' => '<p><strong>Mã nguồn rõ ràng hơn</strong>, <strong>kiểu dữ liệu chặt chẽ hơn</strong> và <strong>I/O có khả năng mở rộng tốt hơn</strong>.</p>',

'features_pfa_description' => '<p>Cho phép cung cấp trước một số đối số của hàm, trả về một Closure chấp nhận phần còn lại.</p>',
'features_readonly_property_defaults_description' => '<p>Cho phép thuộc tính chỉ đọc khai báo giá trị mặc định, do đó không cần gán giá trị cố định trong hàm khởi tạo.</p>',
'features_polling_api_description' => '<p>Ghép kênh I/O có thể mở rộng bằng epoll, kqueue và các cơ chế gốc khác, có sẵn cho các thư viện vòng lặp sự kiện như ReactPHP và AMPHP.</p>',
'features_clamp_description' => '<p>Đảm bảo rằng một giá trị nhất định (số hoặc khác) nằm trong phạm vi được chỉ định.</p>',
'features_duration_description' => '<p>Lớp Duration biểu thị thời gian đã trôi qua được đo bằng đồng hồ bấm giờ.</p>',
'features_sort_direction_description' => '<p>Một cách chuẩn, an toàn kiểu để biểu thị thứ tự sắp xếp có thể dùng chung giữa các thư viện.</p>',

'pfa_title' => 'Áp dụng hàm từng phần',
'pfa_description' => 'Cho phép truyền trước một số đối số của hàm bằng các ký hiệu giữ chỗ <code>?</code> và <code>...</code> cho phần còn lại. Kết quả trả về là một Closure, và hàm chỉ được gọi khi các đối số còn lại được truyền vào.',
'readonly_property_defaults_title' => 'Giá trị mặc định cho thuộc tính Readonly',
'readonly_property_defaults_description' => 'Các thuộc tính readonly của thực thể (instance), bao gồm cả trong lớp readonly, giờ đây có thể khai báo giá trị mặc định. Điều này giúp triển khai các thuộc tính chỉ đọc (get-only) của interface với giá trị cố định đơn giản hơn, vốn trước đây phải gán trong constructor. Giá trị mặc định được tính là bước khởi tạo thuộc tính, nên constructor không thể ghi đè.',
'polling_api_title' => 'Polling API',
'polling_api_description' => 'API <code>Io\Poll</code> mới theo dõi hiệu quả nhiều stream cùng lúc bằng cơ chế tốt nhất có sẵn trên từng nền tảng (epoll, kqueue, event ports hoặc WSAPoll), không bị giới hạn khả năng mở rộng như <code>stream_select()</code>. API này được thiết kế làm nền tảng chung để các thư viện vòng lặp sự kiện (event loop) như ReactPHP và AMPHP xây dựng tiếp.',
'clamp_title' => 'Hàm <code>clamp()</code> mới',
'clamp_description' => 'Đảm bảo một giá trị cho trước (dạng số hoặc kiểu khác) nằm trong một khoảng xác định. Nếu nằm ngoài, giá trị biên gần nhất sẽ được trả về.',
'duration_title' => 'Lớp <code>\Time\Duration</code> mới',
'duration_description' => 'Lớp Duration biểu thị khoảng thời gian đã trôi qua được đo bằng đồng hồ bấm giờ. Cách biểu diễn của nó độc lập với mọi thời điểm và múi giờ, có thể biểu thị khoảng thời gian hơn 250 năm với độ chính xác đến từng nano giây. Nhờ đó, nó rất phù hợp để biểu diễn timeout hoặc đo benchmark một cách rõ ràng, biểu đạt tốt.',
'sort_direction_title' => 'Enum <code>SortDirection</code> mới',
'sort_direction_description' => '<p>Enum <code>SortDirection</code> cung cấp một cách chuẩn, an toàn kiểu để biểu thị thứ tự sắp xếp thông qua hai case <code>Ascending</code> và <code>Descending</code>. Trước đây, mỗi thư viện phải tự định nghĩa cách biểu diễn hướng sắp xếp, dẫn đến sự pha trộn không tương thích giữa số nguyên, chuỗi, boolean và các enum tự tạo. Vì <code>SortDirection</code> được tích hợp sẵn vào PHP, các thư viện có thể nhận nó trong public API mà không cần code chuyển đổi (adapter).</p><p>Tìm hiểu thêm về tính năng này tại <a href="https://thephp.foundation/blog/2026/11/03/stdlib-investment/" target="_blank" rel="noopener noreferrer">blog của The PHP Foundation</a>.</p>',
'stream_error_handling_title' => 'Xử lý lỗi Stream',
'stream_error_handling_description' => 'Các thao tác trên stream giờ đây có thể được cấu hình để ném ra <code>StreamException</code> hoặc thất bại âm thầm thay vì phát cảnh báo (warning). Lỗi được báo cáo dưới dạng các đối tượng <code>StreamError</code> có cấu trúc kèm case enum <code>StreamErrorCode</code>, tên wrapper và đường dẫn hoặc URL bị ảnh hưởng, đồng thời có thể lấy lại sau đó bằng <code>stream_last_errors()</code> hoặc truyền cho trình xử lý lỗi tùy chỉnh.',
'doc_comments_title' => 'DocComments cho tham số hàm',
'doc_comments_description' => 'Tham số của hàm và phương thức giờ đây có thể có DocComment riêng, truy cập được thông qua phương thức <code>ReflectionParameter::getDocComment()</code> mới. Điều này cho phép tài liệu hóa từng tham số ngay cạnh chỗ khai báo mà không cần lặp lại tên và kiểu trong thẻ <code>@param</code>.',
'isreadable_iswriteable_title' => 'Các phương thức <code>ReflectionProperty::isReadable()</code> và <code>ReflectionProperty::isWritable()</code> mới',
'isreadable_iswriteable_description' => 'Với thuộc tính readonly, khả năng hiển thị bất đối xứng (asymmetric visibility) và property hook, việc chỉ kiểm tra xem thuộc tính có phải là public hay không không còn đủ để biết nó có thể đọc hay ghi. Các phương thức mới trả lời trực tiếp câu hỏi này cho một phạm vi (scope) cho trước, và tùy chọn cho một đối tượng cụ thể, có tính đến visibility, trạng thái khởi tạo, hook và các magic method.',

'new_classes_title' => 'Các tính năng và cải tiến bổ sung',
'new_override_constants' => 'Attribute <code>#[\Override]</code> giờ đây có thể áp dụng cho hằng số của lớp (class constant) và các case của enum.',
'new_enum_debug_info' => 'Enum giờ đây có thể triển khai magic method <code>__debugInfo()</code>.',
'new_const_object_writes' => 'Thuộc tính của các đối tượng lưu trong hằng số giờ đây có thể được sửa trực tiếp, ví dụ: <code>Config::DEFAULTS-&gt;timeout = 30</code>.',
'new_uri_builder' => 'Các lớp <code>Uri\Rfc3986\UriBuilder</code> và <code>Uri\WhatWg\UrlBuilder</code> mới tạo URI từ các thành phần của chúng, cùng với các phương thức mới để phát hiện kiểu URI và host, cũng như hàm <code>Uri\WhatWg\url_percent_encode()</code>.',
'new_sodium' => 'Extension Sodium bổ sung đóng gói khóa hậu lượng tử (X-Wing và ML-KEM-768), mã hóa địa chỉ IP, cùng các hàm đầu ra mở rộng SHAKE và TurboSHAKE.',
'new_tls' => 'Các luồng TLS giờ đây hỗ trợ khôi phục phiên (session resumption), khóa chia sẻ trước bên ngoài (external pre-shared keys) và dữ liệu sớm TLS 1.3 (0-RTT).',
'new_mysqli_quote_string' => 'Phương thức <code>mysqli::quote_string()</code> mới escape chuỗi và bọc trong dấu ngoặc kép, tương đồng với <code>PDO::quote()</code>.',
'new_pack_endianness' => '<code>pack()</code> và <code>unpack()</code> giờ đây chấp nhận các ký hiệu endianness <code>&lt;</code> và <code>&gt;</code> trên mã định dạng số nguyên và số thực.',
'new_json_error_location' => 'Thông báo lỗi JSON giờ đây bao gồm vị trí xảy ra lỗi trong dữ liệu đầu vào.',
'new_error_include_args' => 'Thiết lập INI <code>error_include_args</code> mới đưa đối số của hàm vào thông báo lỗi một cách nhất quán.',
'new_intl' => 'Hàm <code>grapheme_strrev()</code> mới đảo ngược chuỗi theo cụm grapheme, và lớp <code>IntlNumberRangeFormatter</code> mới định dạng các khoảng số.',
'new_zip' => 'Các phương thức <code>ZipArchive::openString()</code> và <code>ZipArchive::closeString()</code> mới làm việc với kho lưu trữ (archive) trong bộ nhớ.',
'new_performance' => 'Các cải tiến hiệu năng bao gồm biên dịch <code>array_map()</code> với callback dạng first-class callable hoặc partial application thành vòng lặp, gọi <code>printf()</code> nhanh hơn, cache closure không trạng thái (stateless closure) và mã hóa JSON nhanh hơn.',

'bc_title' => 'Các tính năng bị deprecated và thay đổi phá vỡ tính tương thích ngược',
'bc_return_in_finally' => 'Dùng <code>return</code> bên trong khối <code>finally</code> giờ đây đã bị deprecated, vì nó âm thầm bỏ qua ngoại lệ (exception) và ghi đè giá trị trả về từ khối <code>try</code> hoặc <code>catch</code>.',
'bc_constructor_return' => 'Trả về giá trị từ <code>__construct()</code> hoặc <code>__destruct()</code> giờ đây bị deprecated, cũng như biến chúng thành generator. Khai báo kiểu trả về nullable cho <code>__debugInfo()</code> cũng bị deprecated.',
'bc_reserved_identifiers' => 'Dùng <code>let</code> hoặc <code>is</code> làm tên lớp, hàm hoặc hằng số giờ đây bị deprecated. Dùng <code>_</code> làm tên hằng số, <code>namespace</code> làm tên hằng số của lớp, hoặc <code>readonly</code> làm tên hàm cũng bị deprecated.',
'bc_mbregex' => 'Các hàm biểu thức chính quy của mbstring như <code>mb_ereg()</code> và <code>mb_split()</code> đã bị deprecated, vì thư viện Oniguruma bên dưới không còn được duy trì. Có thể dùng các hàm PCRE với modifier <code>u</code> thay thế.',
'bc_type_aliases' => 'Các bí danh (alias) <code>is_double()</code>, <code>is_long()</code>, <code>is_integer()</code> và <code>doubleval()</code> đã bị deprecated. Hãy dùng <code>is_float()</code>, <code>is_int()</code> và <code>floatval()</code> thay thế.',
'bc_spl_object_hash' => '<code>spl_object_hash()</code> đã bị deprecated để chuyển sang dùng <code>spl_object_id()</code>, và <code>spl_classes()</code> chuyển sang dùng <code>ReflectionExtension::getClassNames()</code>.',
'bc_objects_as_arrays' => 'Truyền đối tượng vào nơi mong đợi mảng ở <code>array_walk()</code>, <code>array_walk_recursive()</code>, <code>http_build_query()</code>, <code>mb_convert_variables()</code> cùng các hàm và bộ lọc nén giờ đây bị deprecated. Hãy dùng <code>get_object_vars()</code> để chuyển đổi đối tượng trước.',
'bc_strcoll' => '<code>strcoll()</code> và cờ sắp xếp <code>SORT_LOCALE_STRING</code> đã bị deprecated. Hãy dùng lớp <code>Collator</code> từ extension intl thay thế.',
'bc_ignored_arguments' => 'Truyền đối số thứ ba cho <code>define()</code> giờ đây bị deprecated, cũng như gọi <code>is_a()</code> hoặc <code>is_subclass_of()</code> với chuỗi tên lớp khi <code>$allow_string</code> là <code>false</code>.',
'bc_php_filter' => 'Dùng quá 16 bộ lọc trong URL <code>php://filter</code> mà không thiết lập tùy chọn context <code>filter.max_filter_count</code> giờ đây bị deprecated.',
'bc_session_defaults' => 'Session giờ đây an toàn hơn theo mặc định: <code>session.use_strict_mode</code> và <code>session.cookie_httponly</code> được bật, còn <code>session.cookie_samesite</code> được đặt thành <code>Lax</code>.',
'bc_session_handlers' => 'Các session handler tùy chỉnh không triển khai đồng thời cả <code>create_sid()</code> và <code>validateId()</code> giờ đây bị deprecated.',
'bc_other_deprecations' => 'Các hàm <code>metaphone()</code>, <code>mysqli_get_charset()</code> và <code>mysqli_stmt_init()</code> giờ đây bị deprecated, cùng với các phương thức CSV của <code>SplFileObject</code> và các phương thức sắp xếp, cờ, tuần tự hóa (serialization) của <code>ArrayIterator</code>.',
'bc_trim_form_feed' => '<code>trim()</code>, <code>ltrim()</code> và <code>rtrim()</code> giờ đây cũng loại bỏ ký tự form feed (<code>\f</code>) theo mặc định.',
'bc_stream_close_errors' => '<code>fclose()</code>, <code>file_put_contents()</code> và <code>copy()</code> giờ đây trả về <code>false</code> khi flush hoặc đóng stream thất bại, thay vì âm thầm bỏ qua lỗi.',
'bc_value_errors' => 'Nhiều hàm giờ đây ném ra <code>ValueError</code> cho các giá trị nằm ngoài phạm vi, cờ không hợp lệ hoặc chuỗi chứa byte NUL, thay vì âm thầm cắt bớt hoặc bỏ qua.',

'footer_title' => 'Cú pháp tốt hơn, hiệu năng cải thiện và an toàn kiểu hơn.',
'footer_description' => '<p class="first-paragraph">Danh sách đầy đủ các thay đổi được ghi nhận trong <a href="/ChangeLog-8.php#PHP_8_6" target="_blank">ChangeLog</a>.</p><p>Vui lòng tham khảo <a href="/manual/en/migration86.php" target="_blank">hướng dẫn di chuyển (migration guide)</a> để xem danh sách chi tiết các tính năng mới và thay đổi không tương thích ngược.</p>',
];
5 changes: 5 additions & 0 deletions public/releases/8.6/vi.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
<?php

$lang = 'vi';

require_once __DIR__ . '/release.inc';