🐞
Хавфсизлик

APP_DEBUG=true: ишчи серверда қолдирилган хавфли хато

20.11.2026
← Барча мақолалар

Laravel'да дастур ёзаётганда debug режим жуда қулай: хато юз берганда экранда чиройли саҳифа очилади, унда қайси файлнинг қайси қаторида муаммо борлиги, чақирувлар занжири, сўров маълумотлари ва илова ҳолати кўрсатилади. Муаммо шундаки, бу қулайлик дастурчи учун мўлжалланган, аммо сайт интернетга чиққанда худди шу саҳифани исталган ташрифчи кўриши мумкин. Ишчи серверда .env файлида APP_DEBUG=true қолдириш Laravel лойиҳаларида энг кўп учрайдиган ва энг қимматга тушадиган хатолардан бири.

Хато саҳифасида аслида нима кўринади

Debug режим ёқиқ бўлса, ишлов берилмаган ҳар қандай истисно батафсил саҳифани чиқаради. Laravel версиясига ва ўрнатилган пакетларга қараб, бу саҳифада қуйидагилар кўриниши мумкин: сервердаги тўлиқ файл йўллари, хато бўлган жой атрофидаги манба коди, маълумотлар базасига юборилган SQL сўрови, сўров сарлавҳалари ва cookie'лар, сессия маълумотлари, баъзи ҳолларда эса муҳит ўзгарувчилари. Муҳит ўзгарувчилари орасида маълумотлар базаси пароли, почта сервери пароли, SMS шлюзи ёки тўлов тизимининг API калитлари бўлиши мумкин.

Хатони қўзғатиш эса қийин эмас. Масалан, формага кутилмаган турдаги қиймат юбориш, мажбурий параметрни тушириб қолдириш ёки маълумотлар базаси вақтинча жавоб бермаган пайтга тўғри келиш кифоя. Автоматик сканерлар Laravel сайтларини аниқлаб, атайлаб хато чиқарадиган сўровлар юборади ва жавобда debug саҳифаси бор-йўқлигини текширади.

Debug режим ва масофадан код бажариш

Debug режимнинг хавфи фақат маълумот сизиб чиқиши билан чекланмайди. 2021 йилда Laravel'нинг хато саҳифаларини чиқарувчи Ignition пакетида жиддий заифлик топилган эди (CVE-2021-3129): debug режим ёқиқ бўлган ва пакетнинг эски версияси ўрнатилган сайтларда ҳужумчи серверда ўз кодини бажариши мумкин эди. Бу заифлик тузатилган, аммо ундан сабоқ оддий: дастурчи учун мўлжалланган воситалар ишчи серверда турмаслиги керак. Одатий Laravel лойиҳасида Ignition require-dev бўлимида туради, шунинг учун серверга composer install --no-dev билан ўрнатиш уни умуман олиб ташлайди.

Мисол: мактаб электрон журнали

Тошкентдаги хусусий мактаб учун ўқувчилар баҳолари ва давоматини юритувчи илова maktab.example.uz манзилида ишга туширилди. Ишга тушириш куни дастурчи хатоларни тез кўриш учун debug режимни вақтинча ёқди ва кейин уни ўчиришни унутди. Бир неча ҳафта ўтиб, ота-оналардан бири баҳолар саҳифаси хато билан очилганини ва экранда қандайдир код ва паролларга ўхшаш сатрлар чиққанини айтди. Бу яхши ниятли одам эди, аммо худди шу саҳифани автоматик сканер ҳам кўрган бўлиши мумкин. Бундай ҳолатда фақат debug режимни ўчириш етарли эмас, қуйида тушунтирилгандек барча сирларни алмаштириш керак бўлади.

Сайтингизда debug ёқиқлигини қандай текшириш

Энг ишончли усул сервернинг ўзида текшириш. Laravel'нинг янги версияларида about буйруғи муҳит ва debug ҳолатини кўрсатади:

php artisan about --only=environment
php artisan tinker --execute="var_dump(config('app.debug'));"
grep -E "^APP_(ENV|DEBUG)=" .env

Иккинчи буйруқ илова амалда қайси қиймат билан ишлаётганини кўрсатади, учинчиси эса .env файлида нима ёзилганини. Бу икки натижа фарқ қилиши мумкин ва бу тасодиф эмас, чунки кейинги бўлимда тушунтирилган кеш тузоғи айнан шунга олиб келади. Ташқаридан ҳам текшириш фойдали: Ignition ўрнатилган баъзи версияларда /_ignition/health-check манзили debug режимда жавоб қайтаради. Бу манзил 404 бермаса, дарҳол сервер томонда текширинг.

Тўғри ўчириш ва config:cache тузоғи

Ишчи сервердаги .env файлида иккала қатор ҳам қуйидагича бўлиши керак:

APP_ENV=production
APP_DEBUG=false

Кўп дастурчилар шу ерда тўхтайди ва муаммо ҳал бўлди деб ўйлайди. Лекин агар аввал php artisan config:cache буйруғи бажарилган бўлса, Laravel созламаларни .env файлидан эмас, bootstrap/cache/config.php даги кешдан ўқийди. Яъни файлни таҳрирлаганингиз ҳеч нарсани ўзгартирмайди, debug режим ёқиқлигича қолади. Шунинг учун ҳар бир ўзгаришдан кейин кешни қайта яратинг:

php artisan config:clear
php artisan config:cache
php artisan about --only=environment

Охирги буйруқ билан натижани албатта текширинг. Debug ўчирилгандан кейин фойдаланувчилар хато бўлганда оддий "Server Error" саҳифасини кўради, батафсил маълумот эса storage/logs папкасидаги журналга ёзилади. Хатоларни тезроқ билиш учун журналдан ташқари хато кузатув хизматини ҳам улаш мумкин, фақат унга юбориладиган маълумотларда парол ва шахсий маълумотлар бўлмаслигини созланг.

Debug очиқ қолган бўлса: оқибатларни бартараф этиш

Агар сайт debug режимда оммага очиқ турган бўлса, сирлар аллақачон кимдадир бўлиши мумкин деб ҳисоблаш тўғри. Debug режимни ўчиргандан кейин қуйидагиларни кетма-кет бажаринг:

  1. Маълумотлар базаси фойдаланувчисининг паролини алмаштиринг ва янгисини .env га ёзинг.
  2. Почта, SMS, тўлов тизими ва бошқа ташқи хизматларнинг API калитларини улар кабинетида янгиланг.
  3. APP_KEY ни алмаштиришни кўриб чиқинг; бу барча сессияларни бекор қилади ва эски калит билан шифрланган маълумотларга таъсир қилади.
  4. Кириш журналларидан шубҳали сўровларни қидиринг.
grep "_ignition" /var/log/nginx/access.log
grep -c " 500 " /var/log/nginx/access.log

Журнал файлларининг жойлашуви хостингга қараб фарқ қилади; sayt.uz хостингида уларни ISPmanager панели орқали кўриш мумкин. _ignition манзилларига мурожаатлар ёки қисқа вақт ичидаги кўп сонли 500 жавоблар кимдир сайтни атайлаб синаб кўрганини билдиради. Бундай ҳолатда маълумотлар базасида янги администратор аккаунтлари ёки ўзгарган ёзувлар бор-йўқлигини ҳам текширинг.

Бу хато қайтмаслиги учун

Энг яхши ҳимоя бу хатони жараён даражасида йўқ қилиш. Ишчи сервер учун .env файлини алоҳида сақланг ва уни ҳеч қачон локал нусхадан кўчирманг. Жойлаштириш скриптига debug ҳолатини текширувчи қадам қўшинг: агар APP_DEBUG рост бўлса, жойлаштириш тўхтасин. Вақтинча диагностика керак бўлса, debug режимни ёқиш ўрнига журнални ўқинг ёки илованинг синов нусхасидан фойдаланинг.

Ўхшаш мақолалар

📱 .htaccess орқали йўналтириш ҳужуми: мобил фойдаланувчилар бошқа сайтга кетади 🚪 WordPress'да бэкдорни топиш: 10 та аниқ белги ва текширув буйруқлари 🛡️ DLE сайтни ҳимоялаш: лицензия, администратор панели ва uploads папкаси 🖱️ Кликжекинг: X-Frame-Options ва CSP билан сайтни ҳимоялаш
🌐 Тил
🇺🇿 O'zbek 🇺🇿 Ўзбек ✓ 🇷🇺 Русский 🇬🇧 English