PHPackages                             bit-01/sy-faker - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Testing &amp; Quality](/categories/testing)
4. /
5. bit-01/sy-faker

ActiveLibrary[Testing &amp; Quality](/categories/testing)

bit-01/sy-faker
===============

A PHP package for generating realistic Syrian Arabic fake data—names, addresses, text, and more. Designed for Laravel 8–12 with a Faker-like API, it delivers authentic Syrian dialect content, from Damascene streets to Aleppine names. Perfect for testing, seeding databases, or placeholder content with local flavor.

v1.0.3(9mo ago)287↓33.3%MITPHPPHP &gt;=7.4

Since Aug 1Pushed 9mo agoCompare

[ Source](https://github.com/bit-01/sy-faker)[ Packagist](https://packagist.org/packages/bit-01/sy-faker)[ RSS](/packages/bit-01-sy-faker/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (2)Versions (4)Used By (0)

SyFaker
=======

[](#syfaker)

[![Laravel](https://camo.githubusercontent.com/6856d731b15ecc7aadbb205efeccd811b27114c15baa5b16472308afedb83c4c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d3825453225383025393331322d6635333030333f7374796c653d666c6174266c6f676f3d6c61726176656c266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/6856d731b15ecc7aadbb205efeccd811b27114c15baa5b16472308afedb83c4c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d3825453225383025393331322d6635333030333f7374796c653d666c6174266c6f676f3d6c61726176656c266c6f676f436f6c6f723d7768697465)[![PHP](https://camo.githubusercontent.com/60b7c89144170307dd3ee47260782923d4156bebdba8f0f1c9975f21c307aef7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d372e34254532253830253933382e342d3446354239333f7374796c653d666c6174266c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/60b7c89144170307dd3ee47260782923d4156bebdba8f0f1c9975f21c307aef7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d372e34254532253830253933382e342d3446354239333f7374796c653d666c6174266c6f676f3d706870266c6f676f436f6c6f723d7768697465)[![License](https://camo.githubusercontent.com/2cf325907ccad33920ad27f842b4bde688339d95ee98033e10401db5cd0e697c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6269742d30312f73792d66616b65723f7374796c653d666c6174)](https://camo.githubusercontent.com/2cf325907ccad33920ad27f842b4bde688339d95ee98033e10401db5cd0e697c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6269742d30312f73792d66616b65723f7374796c653d666c6174)[![Packagist Version](https://camo.githubusercontent.com/e1f1f739365dc98324512cec2b63ca308223090acec1ae38897270cc63fa0f37/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6269742d30312f73792d66616b65723f7374796c653d666c6174)](https://camo.githubusercontent.com/e1f1f739365dc98324512cec2b63ca308223090acec1ae38897270cc63fa0f37/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6269742d30312f73792d66616b65723f7374796c653d666c6174)[![Downloads](https://camo.githubusercontent.com/88bd4a741bf32b8c156f993e895dc87fee0b80d7f6de6afbeb5703db8ed32d46/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6269742d30312f73792d66616b65723f7374796c653d666c6174)](https://camo.githubusercontent.com/88bd4a741bf32b8c156f993e895dc87fee0b80d7f6de6afbeb5703db8ed32d46/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6269742d30312f73792d66616b65723f7374796c653d666c6174)

[![SyFaker](image.png)](image.png)

A PHP package for generating realistic Syrian Arabic fake data—names, addresses, text, and more. Designed for Laravel 8–12 with a Faker-like API, it delivers authentic Syrian dialect content, from Damascene streets to Aleppine names. Perfect for testing, seeding databases, or placeholder content with local flavor. Index
-----

[](#index)

1. [Features](#features)
2. [Installation](#installation)
3. [Usage](#usage)
    1. [Laravel Integration](#laravel-integration)
4. [API](#api)
5. [Laravel &amp; PHP Compatibility](#-laravel--php-compatibility)
6. [License](#license)
7. [Arabic Readme File](./README-AR.md)

Features
--------

[](#features)

- Syrian Text and paragraphs
- Syrian names
- Syrian addresses
- Syrian phone numbers (mobile, landline, Syriatel, MTN)
- Syrian dialect text
- Gregorian and Hijri dates with Syrian format
- Syrian company names, job titles, and business types
- Syrian foods, idioms, proverbs, and traditional items
- Faker-like API

Installation
------------

[](#installation)

```
composer require bit-01/sy-faker
```

Usage
-----

[](#usage)

```
use Bit\SyFaker\SyFaker;

$syFaker = new SyFaker();

// Text and Paragraphs
$faker->word(); // e.g., "مبسوط", "إيمتى", "سوريا", "رفيق", "عنجد"
$faker->words(5); // e.g., "مرحبا كيفك عنجد شوي منيح"
$faker->words(5, true); //e.g., ['مرحبا', 'كيفك', 'عنجد', 'شوي', 'منيح']
$faker->sentences(2); // e.g., "شو صاير معك؟ العمل الجاد يؤدي إلى النجاح."
$faker->sentences(2, 'msa', false, ' | '); // e.g., "ذهبت إلى السوق | إن التعليم هو أساس تقدم الأمم."
$faker->sentence(); // e.g., "شو صاير معك؟"
$faker->sentence('msa'); // e.g., "ذهبت إلى السوق لشراء بعض الحاجيات."
$faker->sentence('dialect'); // e.g., "خلص بكفي لهون."
$faker->paragraph(); // default mixed
$faker->paragraph(4, 6, 'msa'); // only Modern Standard Arabic
$faker->paragraph(5, 8, 'dialect'); // only Syrian dialect

// Names
$faker->name(); // e.g., "علي الحلبي"
$faker->firstName(); // e.g., "مريم"
$faker->lastName(); // e.g., "الدمشقي"

// Addresses
$faker->address(); // e.g., "دمشق، المزة، شارع الحمرا، بناء رقم 12"

// Phone Numbers
$faker->mobile(); // e.g., "+963 93 123 4567" (random company)
$faker->mobile(false); // e.g., "093 123 4567" (without country code)
$faker->mobile(true, 'syriatel'); // e.g., "+963 93 123 4567" (Syriatel)
$faker->mobile(true, 'mtn'); // e.g., "+963 94 123 4567" (MTN Syria)
$faker->syriatel(); // e.g., "+963 93 123 4567"
$faker->mtn(); // e.g., "+963 94 123 4567"
$faker->landline(); // e.g., "+963 11 123 4567"
$faker->landline(false); // e.g., "011 123 4567"

// Dates
$faker->gregorianDate(); // e.g., "22/07/2025"
$faker->hijriDate();     // e.g., "16/01/1447"
$faker->randomGregorianDate('-2 years', 'now'); // e.g., "05/06/2023"
$faker->randomHijriDate('-2 years', 'now'); // e.g., "15/02/1445"

// Companies
$faker->companyName();  // e.g., "شركة النور محدودة المسؤولية"

// Job Titles
$faker->jobTitle();     // e.g., "مهندس برمجيات"

// Business Types
$faker->businessType(); // e.g., "تكنولوجيا المعلومات"

// Syrian foods
$faker->food();            // e.g., "شيش برك"
// idioms
$faker->idiom();           // e.g., "بيضحك عالمشنقة"
// proverbs
$faker->proverb();         // e.g., "كل تأخيرة فيها خيرة"
// traditional items
$faker->traditionalItem(); // e.g., "مروحة يدوية"
// sentence of: Syrian foods, idioms, proverbs, and traditional items
$faker->culturalSentence(); // Output: وأنت عم تاكل محشي كوسا جنب صابون الغار، تذكّر المثل الشامي: "كل تأخيرة فيها خيرة".
```

### Laravel Integration

[](#laravel-integration)

The package auto-registers via Service Provider and provides a helper function

```
use Bit\SyFaker\SyFaker;

$syFaker = new SyFaker();

// or you can use the helper function e.g.:
syFaker()->name();
```

API
---

[](#api)

- `$faker->letter()`
- `$faker->word()`
- `$faker->words($count = 5, $asArray = false, $separator = ' ')`
- `$faker->sentence($mode = 'mixed')`
- `$faker->sentences($count = 3, $mode = 'mixed', $asArray = false, $separator = ' ')`
- `$faker->paragraph($min = 3, $max = 7, $mode = 'mixed')`
- `$faker->name($gender = null)`
- `$faker->firstName($gender = null)`
- `$faker->lastName()`
- `$faker->address()`
- `$faker->mobile($withCountryCode = true, $company = null)`
- `$faker->syriatel($withCountryCode = true)`
- `$faker->mtn($withCountryCode = true)`
- `$faker->landline($withCountryCode = true)`
- `$faker->gregorianDate($format = 'd/M/Y')`
- `$faker->hijriDate($format = 'd/m/Y')`
- `$faker->randomGregorianDate($start = '-10 years', $end = 'now', $format = 'd/M/Y')`
- `$faker->randomHijriDate($start = '-10 years', $end = 'now', $format = 'd/m/Y')`
- `$faker->companyName()`
- `$faker->jobTitle()`
- `$faker->businessType()`
- `$faker->food()`
- `$faker->idiom()`
- `$faker->proverb()`
- `$faker->traditionalItem()`
- `$faker->culturalSentence()`

✅ Laravel &amp; PHP Compatibility
---------------------------------

[](#-laravel--php-compatibility)

Laravel VersionPHP 7.4PHP 8.0PHP 8.1PHP 8.2PHP 8.3PHP 8.4Laravel 8✅✅✅✅❌❌Laravel 9❌✅✅✅✅❌Laravel 10❌✅✅✅✅✅Laravel 11❌❌✅✅✅✅Laravel 12❌❌✅✅✅✅> ❌ = Not supported
> ✅ = Fully supported

License
-------

[](#license)

MIT

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance56

Moderate activity, may be stable

Popularity14

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

290d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/33225054?v=4)[Bit](/maintainers/bit-01)[@bit-01](https://github.com/bit-01)

---

Top Contributors

[![bit-01](https://avatars.githubusercontent.com/u/33225054?v=4)](https://github.com/bit-01 "bit-01 (24 commits)")

### Embed Badge

![Health badge](/badges/bit-01-sy-faker/health.svg)

```
[![Health](https://phpackages.com/badges/bit-01-sy-faker/health.svg)](https://phpackages.com/packages/bit-01-sy-faker)
```

###  Alternatives

[larastan/larastan

Larastan - Discover bugs in your code without running it. A phpstan/phpstan extension for Laravel

6.4k43.5M5.2k](/packages/larastan-larastan)[timacdonald/log-fake

A drop in fake logger for testing with the Laravel framework.

4235.9M56](/packages/timacdonald-log-fake)[illuminate/testing

The Illuminate Testing package.

3315.6M113](/packages/illuminate-testing)[christophrumpel/missing-livewire-assertions

This package adds missing livewire test assertions.

149336.0k9](/packages/christophrumpel-missing-livewire-assertions)[calebdw/larastan-livewire

A Larastan / PHPStan extension for Livewire.

43482.4k3](/packages/calebdw-larastan-livewire)[encodia/laravel-health-env-vars

Custom check for Spatie's Laravel Health - Ensure every .env variable you need has been set

20143.5k](/packages/encodia-laravel-health-env-vars)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
