From 34d848c7030be4101fc225540b32377453891c05 Mon Sep 17 00:00:00 2001
From: Guilherme Nascimento <brcontainer@yahoo.com.br>
Date: Tue, 8 Sep 2026 09:20:43 -0300
Subject: [PATCH 1/2] Fixes Example #2 using fileperms

Same as: https://github.com/php/doc-en/pull/5842

Incorrect:

```php
case 0x8000: // regular
    $info = 'r';
```
---
 reference/filesystem/functions/fileperms.xml | 50 +++++++-------------
 1 file changed, 17 insertions(+), 33 deletions(-)

diff --git a/reference/filesystem/functions/fileperms.xml b/reference/filesystem/functions/fileperms.xml
index 030bbf37f..7fd42ec02 100644
--- a/reference/filesystem/functions/fileperms.xml
+++ b/reference/filesystem/functions/fileperms.xml
@@ -43,52 +43,36 @@ echo substr(sprintf('%o', fileperms('/etc/passwd')), -4);
 <?php
 $perms = fileperms('/etc/passwd');
 
-if (($perms & 0xC000) == 0xC000) {
-    // Socket
-    $info = 's';
-} elseif (($perms & 0xA000) == 0xA000) {
-    // Symbolic Link
-    $info = 'l';
-} elseif (($perms & 0x8000) == 0x8000) {
-    // Regular
-    $info = '-';
-} elseif (($perms & 0x6000) == 0x6000) {
-    // Block special
-    $info = 'b';
-} elseif (($perms & 0x4000) == 0x4000) {
-    // Directory
-    $info = 'd';
-} elseif (($perms & 0x2000) == 0x2000) {
-    // Character special
-    $info = 'c';
-} elseif (($perms & 0x1000) == 0x1000) {
-    // FIFO pipe
-    $info = 'p';
-} else {
-    // Unknown
-    $info = 'u';
+switch ($perms & 0xF000) {
+    case 0x1000: $info = 'p'; break; // FIFO pipe
+    case 0x2000: $info = 'c'; break; // character special
+    case 0x4000: $info = 'd'; break; // directory
+    case 0x6000: $info = 'b'; break; // block special
+    case 0x8000: $info = '-'; break; // regular
+    case 0xA000: $info = 'l'; break; // symbolic link (reachable when using lstat function)
+    case 0xC000: $info = 's'; break; // socket
+
+    // unknown
+    default: $info = 'u';
 }
 
 // Owner
+$setuid = $perms & 0x0800;
 $info .= (($perms & 0x0100) ? 'r' : '-');
 $info .= (($perms & 0x0080) ? 'w' : '-');
-$info .= (($perms & 0x0040) ?
-            (($perms & 0x0800) ? 's' : 'x' ) :
-            (($perms & 0x0800) ? 'S' : '-'));
+$info .= (($perms & 0x0040) ? ($setuid ? 's' : 'x') : ($setuid ? 'S' : '-'));
 
 // Group
+$setgid = $perms & 0x0400;
 $info .= (($perms & 0x0020) ? 'r' : '-');
 $info .= (($perms & 0x0010) ? 'w' : '-');
-$info .= (($perms & 0x0008) ?
-            (($perms & 0x0400) ? 's' : 'x' ) :
-            (($perms & 0x0400) ? 'S' : '-'));
+$info .= (($perms & 0x0008) ? ($setgid ? 's' : 'x') : ($setgid ? 'S' : '-'));
 
 // World
+$sticky = $perms & 0x0200;
 $info .= (($perms & 0x0004) ? 'r' : '-');
 $info .= (($perms & 0x0002) ? 'w' : '-');
-$info .= (($perms & 0x0001) ?
-            (($perms & 0x0200) ? 't' : 'x' ) :
-            (($perms & 0x0200) ? 'T' : '-'));
+$info .= (($perms & 0x0001) ? ($sticky ? 't' : 'x') : ($sticky ? 'T' : '-'));
 
 echo $info;
 ?>

From 46f57d750fa21ff93508e3b511000221a4ac4edf Mon Sep 17 00:00:00 2001
From: Guilherme Nascimento <brcontainer@yahoo.com.br>
Date: Tue, 8 Sep 2026 10:50:55 -0300
Subject: [PATCH 2/2] EN-Revision

---
 reference/filesystem/functions/fileperms.xml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/filesystem/functions/fileperms.xml b/reference/filesystem/functions/fileperms.xml
index 7fd42ec02..7edc6c846 100644
--- a/reference/filesystem/functions/fileperms.xml
+++ b/reference/filesystem/functions/fileperms.xml
@@ -1,7 +1,7 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!-- splitted from ./it/functions/filesystem.xml, last change in rev 1.15 -->
-<!-- EN-Revision: n/a Maintainer: fernando Status: working -->
-<!-- CREDITS: cortesi -->  
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: f5c4950be0ef12e84eea5276b15a7d143885286c Maintainer: fernando Status: ready -->
+<!-- Credits: cortesi -->
 <refentry xml:id="function.fileperms" xmlns="http://docbook.org/ns/docbook">
    <refnamediv>
     <refname>fileperms</refname>