WordPress Load Test with k6 | تست بار وردپرس با k6

فارسی · English

Warning

Only test websites that you own or are explicitly authorized to test. Start with a low load and monitor the server.

فقط وب‌سایتی را تست کنید که مالک آن هستید یا برای تست آن مجوز صریح دارید. با بار کم شروع کنید و سرور را زیر نظر داشته باشید.

فارسی

یک ابزار سبک و قابل تنظیم برای تست بار و فشار وب‌سایت‌های WordPress با k6. این پروژه می‌تواند با تعداد ثابتی کاربر مجازی یا نرخ ثابت درخواست اجرا شود و شاخص‌های مهمی مانند زمان پاسخ، نرخ شکست و خطاهای 5xx را گزارش کند.

امکانات

• دو روش اجرا: کاربر مجازی (vus) و نرخ ثابت درخواست (rps)
• افزایش و کاهش تدریجی بار در حالت VU
• تنظیم نرخ، مدت تست و ظرفیت VU در حالت RPS
• تست تصادفی چند مسیر WordPress با متغیر PATHS
• متریک اختصاصی wordpress_page_duration برای زمان پاسخ صفحات
• متریک اختصاصی wordpress_5xx_rate برای خطاهای سمت سرور
• بررسی خودکار پاسخ‌های غیر 5xx و پاسخ‌های موفق 2xx/3xx
• آستانه‌های آماده برای نرخ خطا و صدک‌های p95 و p99
• حذف بدنه پاسخ‌ها برای کاهش مصرف حافظه در تست‌های سنگین
• اسکریپت PowerShell برای بارگذاری خودکار تنظیمات از .env

پیش‌نیازها

• Windows و PowerShell برای استفاده از اسکریپت آماده؛ خود فایل k6 روی سایر سیستم‌عامل‌ها نیز قابل اجرا است.
• نصب k6
• Git برای کلون پروژه

نصب k6 در Windows با winget:

winget install GrafanaLabs.k6 --source winget
k6 version

یا با Chocolatey:

choco install k6
k6 version

کلون، نصب و راه‌اندازی

git clone https://github.com/ZamaniDeveloper/wordpress-load-test.git
cd wordpress-load-test
Copy-Item .env.example .env

فایل .env را ویرایش کنید و حداقل TARGET_URL را روی آدرس سایتی بگذارید که مجوز تست آن را دارید. سپس اجرا کنید:

.\run-webava-light.ps1

برای اجرای مستقیم و مستقل از PowerShell:

k6 run wordpress-pressure.js

در این حالت متغیرهای محیطی موردنیاز، به‌ویژه TARGET_URL، باید از قبل در محیط سیستم تنظیم شده باشند.

تنظیمات

متغیر	کاربرد	نمونه
TARGET_URL	آدرس پایه سایت هدف	https://example.com
MODE	روش اجرا: vus یا rps	rps
PATHS	مسیرهای جداشده با کاما	/,/blog/,/wp-json/
SLEEP	مکث هر VU بین تکرارها، به ثانیه	1
VUS	تعداد کاربران مجازی در حالت VU	10
RAMP_UP	زمان افزایش بار در حالت VU	1m
HOLD	زمان ثابت ماندن بار در حالت VU	3m
RAMP_DOWN	زمان کاهش بار در حالت VU	1m
RATE	تعداد درخواست در هر TIME_UNIT در حالت RPS	100
DURATION	مدت اجرای حالت RPS	3m
TIME_UNIT	واحد زمانی نرخ درخواست	1s
PRE_ALLOCATED_VUS	VUهای از پیش تخصیص‌یافته در حالت RPS	80
MAX_VUS	سقف VU در حالت RPS	250

برای تغییر موقت یک مقدار بدون ویرایش .env:

$env:RATE = "25"
$env:DURATION = "1m"
.\run-webava-light.ps1

در خروجی k6 به http_req_failed، http_req_duration، checks و wordpress_5xx_rate توجه کنید. نرخ را تدریجی بالا ببرید و هم‌زمان CPU، حافظه، PHP-FPM، پایگاه داده، CDN و لاگ‌های سرور را پایش کنید. در تست اولیه از مسیرهای /wp-login.php و /wp-admin/ استفاده نکنید، مگر اینکه هدف مشخص شما ارزیابی حفاظت ورود باشد.

---

English

A lightweight, configurable k6 load-testing tool for WordPress websites. It can run with a fixed number of virtual users or a constant request rate and reports response time, failure rate, and server-side 5xx errors.

Features

• Two execution modes: virtual users (vus) and constant request rate (rps)
• Configurable ramp-up, steady load, and ramp-down stages in VU mode
• Configurable request rate, duration, and VU capacity in RPS mode
• Random requests across multiple WordPress paths via PATHS
• Custom wordpress_page_duration response-time metric
• Custom wordpress_5xx_rate server-error metric
• Built-in checks for non-5xx and successful 2xx/3xx responses
• Ready-to-use thresholds for failures and p95/p99 latency
• Discarded response bodies to reduce memory use during heavier tests
• PowerShell launcher that automatically loads settings from .env

Prerequisites

• Windows and PowerShell for the included launcher; the k6 test itself is cross-platform.
• k6
• Git

Install k6 on Windows with winget:

winget install GrafanaLabs.k6 --source winget
k6 version

Or with Chocolatey:

choco install k6
k6 version

Clone, install, and run

git clone https://github.com/ZamaniDeveloper/wordpress-load-test.git
cd wordpress-load-test
Copy-Item .env.example .env

Edit .env and set at least TARGET_URL to a website you are authorized to test. Then run:

.\run-webava-light.ps1

To run k6 directly on any supported operating system:

k6 run wordpress-pressure.js

When running directly, provide the required environment variables—especially TARGET_URL—through your shell or environment.

Configuration

Variable	Purpose	Example
TARGET_URL	Base URL of the target site	https://example.com
MODE	Execution mode: vus or rps	rps
PATHS	Comma-separated request paths	/,/blog/,/wp-json/
SLEEP	Delay between VU iterations in seconds	1
VUS	Virtual-user count in VU mode	10
RAMP_UP	VU ramp-up duration	1m
HOLD	Steady-load duration in VU mode	3m
RAMP_DOWN	VU ramp-down duration	1m
RATE	Requests per TIME_UNIT in RPS mode	100
DURATION	RPS test duration	3m
TIME_UNIT	Request-rate time unit	1s
PRE_ALLOCATED_VUS	Pre-allocated VUs in RPS mode	80
MAX_VUS	Maximum VUs in RPS mode	250

Override values for a single run without editing .env:

$env:RATE = "25"
$env:DURATION = "1m"
.\run-webava-light.ps1

Watch http_req_failed, http_req_duration, checks, and wordpress_5xx_rate in the k6 summary. Increase load gradually while monitoring CPU, memory, PHP-FPM workers, the database, CDN, and server logs. Avoid /wp-login.php and /wp-admin/ during an initial test unless login-protection testing is your explicit goal.