README

HTTP хүсэлт илгээх болон MIME имэйл боловсруулах/илгээх энгийн хөнгөн жинтэй, объект хандалтат http-client компонент.

Агуулга / Table of Contents

Монгол | 2. English | 3. Getting Started

1. Монгол тайлбар

codesaur/http-client нь codesaur ecosystem-ийн нэг хэсэг бөгөөд хөнгөн жинтэй, фрэймворкоос үл хамааран standalone байдлаар ашиглаж болох PHP HTTP клиент компонент юм.

Багц нь дараах 3 үндсэн class-аас бүрдэнэ:

CurlClient - cURL дээр суурилсан уян хатан HTTP клиент
JSONClient - JSON өгөгдөлтэй REST API-тэй ажиллахад тохиромжтой
Mail - HTML + Text + олон хавсралттай MIME имэйл илгээгч

Онцлох боломжууд

✔ UTF-8 бүрэн дэмжлэг (нэрс, файлын нэр, гарчиг г.м.)
✔ Хөнгөн, хурдан, ямар ч фрэймворк дээр эсвэл дангаар ашиглаж болно
✔ Зөвхөн ext-curl, ext-json байхад л болно

Дэлгэрэнгүй мэдээлэл

📖 Бүрэн танилцуулга - Суурилуулалт, хэрэглээ, жишээнүүд
📚 API тайлбар - Бүх метод, exception-үүдийн тайлбар
🔍 Шалгалтын тайлан - Код шалгалтын тайлан

2. English description

codesaur/http-client is part of the codesaur ecosystem and is a lightweight PHP HTTP client component that can be used standalone, independent of any framework.

The package consists of the following 3 core classes:

CurlClient - flexible HTTP client based on cURL
JSONClient - convenient for working with REST APIs with JSON data
Mail - MIME email sender with HTML + Text + multiple attachments

Key Features

✔ Full UTF-8 support (names, file names, headers, etc.)
✔ Lightweight, fast, can be used on any framework or standalone
✔ Only requires ext-curl and ext-json

Documentation

📖 Full Documentation - Installation, usage, examples
📚 API Reference - Complete API documentation
🔍 Review - Complete package review and code quality assessment

3. Getting Started

Requirements

PHP 8.2.1+
Composer
ext-curl extension
ext-json extension

Installation

Composer ашиглан суулгана / Install via Composer:

composer require codesaur/http-client

Quick Examples

CurlClient - Ерөнхий HTTP клиент

use codesaur\Http\Client\CurlClient;

// CurlClient үүсгэх / Create CurlClient instance
$curl = new CurlClient();

// GET хүсэлт илгээх / Send GET request
$response = $curl->request(
    'https://httpbin.org/get',
    'GET'
);

// Хариуг хэвлэх / Print response
echo $response;

JSONClient - JSON API-тэй ажиллах

use codesaur\Http\Client\JSONClient;

// JSONClient үүсгэх / Create JSONClient instance
$client = new JSONClient();

// GET хүсэлт илгээх / Send GET request
$response = $client->get(
    'https://httpbin.org/get',
    ['hello' => 'world']
);

// POST хүсэлт илгээх / Send POST request
$response = $client->post(
    'https://httpbin.org/post',
    ['test' => 'codesaur']
);

// Хариуг хэвлэх / Print response
print_r($response);

Mail - MIME HTML + Хавсралттай имэйл клиент

use codesaur\Http\Client\Mail;

// Mail үүсгэх / Create Mail instance
$mail = new Mail();

// Хүлээн авагч тохируулах / Set recipient
$mail->targetTo('user@example.com', 'Хэрэглэгч');
// Илгээгч тохируулах / Set sender
$mail->setFrom('no-reply@example.com', 'codesaur');
// Гарчиг тохируулах / Set subject
$mail->setSubject('Сайн байна уу?');
// Зурвас тохируулах / Set message
$mail->setMessage('<h1>Hello!</h1><p>Тест имэйл.</p>');

// Файл хавсралт нэмэх / Add file attachment
$mail->addFileAttachment(__DIR__ . '/file.pdf');
// URL-аас хавсралт нэмэх / Add attachment from URL
$mail->addUrlAttachment('https://example.com/logo.png');

// Имэйл илгээх / Send email
$mail->sendMail();

Running Tests

Тест ажиллуулах / Run tests:

# Бүх тестүүдийг ажиллуулах / Run all tests
composer test

# Зөвхөн unit тест / Unit tests only
composer test:unit

# Зөвхөн integration тест / Integration tests only
composer test:integration

# Coverage-тэй тест ажиллуулах / Run tests with coverage
composer test:coverage

Changelog

📝 CHANGELOG.md - Full version history

Contributing & Security

🤝 Contributing Guide
🔐 Security Policy

License

This project is licensed under the MIT License.

Author

Narankhuu
📧 codesaur@gmail.com
🌐 https://github.com/codesaur

🦖 codesaur ecosystem: https://codesaur.net

codesaur / http-client

Maintainers

Details