From c037b96bbca703130a5520f9ef7ff735a93ee550 Mon Sep 17 00:00:00 2001
From: Guilherme Nascimento <brcontainer@yahoo.com.br>
Date: Thu, 10 Sep 2026 11:30:18 -0300
Subject: [PATCH] Fixes the Example 2 using fileperms

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

```php
case 0x8000: // regular
    $info = 'r';
```

The output in the example for `etc/password` should be:

```
-rw-r--r--
```

But what is obtained is:

```
rrw-r--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 f26dbe3f4..1f67325ef 100644
--- a/reference/filesystem/functions/fileperms.xml
+++ b/reference/filesystem/functions/fileperms.xml
@@ -90,51 +90,35 @@ echo substr(sprintf('%o', fileperms('/etc/passwd')), -4);
 $perms = fileperms('/etc/passwd');
 
 switch ($perms & 0xF000) {
-    case 0xC000: // soket
-        $info = 's';
-        break;
-    case 0xA000: // Sembolik bağ
-        $info = 'l';
-        break;
-    case 0x8000: // Sıradan dosya
-        $info = 'r';
-        break;
-    case 0x6000: // Blok aygıtı
-        $info = 'b';
-        break;
-    case 0x4000: // Dizin
-        $info = 'd';
-        break;
-    case 0x2000: // Karakter aygıtı
-        $info = 'c';
-        break;
-    case 0x1000: // FIFO boru
-        $info = 'p';
-        break;
-    default: // Bilinmiyor
-        $info = 'u';
- }
+    case 0x1000: $info = 'p'; break; // FIFO boru
+    case 0x2000: $info = 'c'; break; // Karakter aygıtı
+    case 0x4000: $info = 'd'; break; // Dizin
+    case 0x6000: $info = 'b'; break; // Blok aygıtı
+    case 0x8000: $info = '-'; break; // Sıradan dosya
+    case 0xA000: $info = 'l'; break; // Sembolik bağ (Bu özellik lstat fonksiyonu kullanılırken kullanılabilir)
+    case 0xC000: $info = 's'; break; // soket
+
+    // Bilinmiyor
+    default: $info = 'u';
+}
 
 // Kullanıcı
+$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' : '-'));
 
 // Grup
+$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' : '-'));
 
 // Herkes
+$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;
 ?>