Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:105881 Return-Path: Delivered-To: mailing list internals@lists.php.net Received: (qmail 98470 invoked from network); 12 Jun 2019 18:22:10 -0000 Received: from unknown (HELO mail-ua1-f54.google.com) (209.85.222.54) by pb1.pair.com with SMTP; 12 Jun 2019 18:22:10 -0000 Received: by mail-ua1-f54.google.com with SMTP id v18so6063477uad.12 for ; Wed, 12 Jun 2019 08:35:06 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:from:date:message-id:subject:to; bh=uz+jKnzq+ZUfTRClRXMMQGJyDaY9GT0npTOlyHLOq8s=; b=q602K5YQz4BcRdeSlxHpxK6BXr3+tp6gUe0bkTnhJD/6mf5+I3zMid2DpFAVaOSSKE qc5hLL9/uoed6fPNTg+EFxEcMnsEugWqu5em9af70KN7LsQUoMDnThNOZpW1Ekfqth61 C0cA+Vagt3Idrrq8xbuiZ34GmGMrXCRnfBmg2DgGR8c7nMS7xl6HTHK5sWtv+ovPTNqE oWXJirIYFRaYfv/7vtlNyCA7Ox9c6EF5VIclz5FG9zuryMShZ8fHKopM7vj4IaK4FVJa W68aAKHaTTJGkNwWebF57FxyguL/Zhj4+9djpQt/CSTFf6hyCLhkmK7MatDwZ8+AKP7j w9+g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=uz+jKnzq+ZUfTRClRXMMQGJyDaY9GT0npTOlyHLOq8s=; b=b81pak5nHmtUKRxCpFudqhm/vpXqILRGLR3czfW+tg70z+/pFhNTdlqOFj+ZGxEdWL DPRreSp6QJVtHkS56thhP6LO8Zw5ERzJlxhdxdCUmr/jS3cmcs1RL8f4UAYLkeRfRrY3 tFt+EorS65/QN6PWkf/H4qBlaJfLjvaeZfxroqIeUgGIUY4F2ddDfJBQLhkAwFgd3kpP cvlYkvC+eJA5LgKh9jwIbIdyHQnz/Y911eFVC78yu+1RzkbBJxqhxuFpBUzFajDnWhzg K+IGHxtKE5EThc3BHH0oEEbfZIUyAWLbswjX+aS8OOQ2mXgfRIWMSs49FvPChceKsgvx mA1A== X-Gm-Message-State: APjAAAVStORZAlfL8tPmn9zpB0GXIq8h15URXRfx1irvG661hPLImlQb Wjt0ULgGmXd39FPPudMVeYjWZjPZG2q1UbOQBWBVuw== X-Google-Smtp-Source: APXvYqwrtD//zSmY2sas1GtBqjkEngiP1GCj2cnt9bv70J9WzTZOS+uAgXIazcxgnyeecyUdYh9FMehe+7IUfIJlzdM= X-Received: by 2002:ab0:2746:: with SMTP id c6mr13500037uap.76.1560353706064; Wed, 12 Jun 2019 08:35:06 -0700 (PDT) MIME-Version: 1.0 Date: Wed, 12 Jun 2019 17:32:58 +0200 Message-ID: To: PHP internals Content-Type: multipart/alternative; boundary="0000000000005fbf7c058b222868" Subject: Feedback on state of some PHP extensions, functions, etc. From: george.banyard@gmail.com ("G. P. B.") --0000000000005fbf7c058b222868 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Hello internal, I've been going through the documentation again to remove mentions of PHP 4 and found some extensions, functions, etc. on which I'd like to know the state of them and if it would be wise to deprecate them. I know I've thrown in some function aliases again, but only those which I think wouldn't have widespread usage. If those should still be kept in your opinion please let me know. The list are more rough notes that I took while reading the doc so if something seems unclear let me know. - ob_gzhandler, it says in a note that zlib.output_compression is preferred. [1] Moreover, it is poorly documented - the enable_dl directive, it is said that "This deprecated feature *will* certainly be *removed* in the future." [x] is this the case already? addressed in the Deprecation for 7.4 draft RFC [2] - ini_alter an alias of ini_set [3] - Deprecate the mode argument in zip_entry_open as it is ignored and always "*rb*" [4] - Deprecate the use_shortnames argument of openssl_csr_get_public_key as it is ignored [5] - odbc_do =E2=80=94 Alias of odbc_exec() ; odbc_field_precision =E2=80= =94 Alias of odbc_field_len() - rewinddir returns null on success and false on failure which is an odd behavior but I suppose it was kept like that due to BC concerns. - The FILE_USE_INCLUDE_PATH constant in the Filesystem extension being an integer makes it unusable with strict types for file_get_contents() [= 6] however it is also used for a flag argument where it can be combined wit= h other constants with a binary OR [7] [8]. Should this be just considered a Doc Bug? - The Enchant extension is bundled with PHP as of PHP 5.3 [9] however it seems its license is LGPL-2.1 [10] isn't this clashing with the PHP Lice= nse? - PharData::setAlias, PharData::setDefaultStub and PharData::setStub always throw PharException [11] [12] [13] - user_error =E2=80=94 Alias of trigger_error() in the Error Handling ex= tension - show_source =E2=80=94 Alias of highlight_file() in Misc Functions - GLOB_AVAILABLE_FLAGS is used internally to check for malformed glob flags [14] but it isn't really documented [15] [16] - Deprecate the NoRewindIterator class in the SPL extension as it seems pretty useless [17] - stream_register_wrapper =E2=80=94 Alias of stream_wrapper_register() in Stream Extension - Deprecate the stream_set_timeout function in favour of stream_select as " This function doesn't work with advanced operations like stream_socket_recvfrom() , use stream_select() with timeout parameter instead" [18] - Change print return's type from int to void as it always returns 1 [19= ] to mimic echo [20] or maybe mimic printf's behavior i.e. the length of t= he string printed [21] - Deprecate the ftp_site function in favour of ftp_raw as ftp_site() does not return the response from the server which isn't really practica= l as can be seen on these two notes [22][23] - ftp_quit =E2=80=94 Alias of ftp_close() - Unbundle the NSAPI Extension (if this is already the case, there is doc error in the membership state of the extension) as it seems obsolete= in this day and age as it handles Sun/Netscape servers [24] - socket_getopt =E2=80=94 Alias of socket_get_option() and socket_setopt= =E2=80=94 Alias of socket_set_option() - Unbundle the XML-RPC extension as it is considered experimental [25] Best regards George P. Banyard [1] https://www.php.net/manual/en/function.ob-gzhandler.php [x] https://www.php.net/manual/en/info.configuration.php [2] https://wiki.php.net/rfc/deprecations_php_7_4 [3] https://www.php.net/manual/en/function.ini-alter.php [4] https://www.php.net/manual/en/function.zip-entry-open.php [5] https://www.php.net/manual/en/function.openssl-csr-get-public-key.php [6] https://www.php.net/manual/en/function.file-get-contents.php [7] https://www.php.net/manual/en/function.file-put-contents.php [8] https://www.php.net/manual/en/function.file.php [9] https://www.php.net/manual/en/enchant.installation.php [10] https://github.com/AbiWord/enchant [11] https://www.php.net/manual/en/phardata.setalias.php [12] https://www.php.net/manual/en/phardata.setdefaultstub.php [13] https://www.php.net/manual/en/phardata.setstub.php [14] https://github.com/php/php-src/blob/master/ext/standard/dir.c#L192 [15] https://www.php.net/manual/en/filesystem.constants.php [16] https://www.php.net/manual/en/function.glob.php [17] https://www.php.net/manual/en/class.norewinditerator.php [18] https://www.php.net/manual/en/function.stream-set-timeout.php#refsect1-func= tion.stream-set-timeout-notes [19] https://www.php.net/manual/en/function.print.php [20] https://www.php.net/manual/en/function.echo.php [21] https://www.php.net/manual/en/function.printf.php [22] https://www.php.net/manual/en/function.ftp-site.php#86838 [23] https://www.php.net/manual/en/function.ftp-site.php#26907 [24] https://www.php.net/manual/en/book.nsapi.php [25] https://www.php.net/manual/en/intro.xmlrpc.php --0000000000005fbf7c058b222868--