README

A lightweight PHP library for scraping weather data from sinoptik.ua — one of Ukraine's most popular weather forecasting websites.

🌦️ Features

Get current weather conditions
Retrieve 10-day forecasts
Access weather details by city
Simple and clean API
No API key required (web scraping based)

⚙️ Installation

You can install the library via Composer:

composer require vkarchevskyi/sinoptik.ua-parser

🚀 Usage

$data = new ScraperFactory()
    ->make()
    ->getCurrentTimeData()

echo json_encode($data);

Example output:

{
  "time": "15:00",
  "data": {
    "description": "Ясно",
    "temperature": "+12",
    "feelsLike": "+12",
    "pressure": "734",
    "humidity": "64",
    "wind": "2.5",
    "precipitationProbability": "54"
  }
}

You can customize scraper by providing city, date or timezone using factory methods:

$data = new ScraperFactory()
    ->setCity('Lviv')
    ->setDate(new DateTimeImmutable('+3 days'))
    ->setTimezone('Europe/Kyiv')
    ->make()
    ->getData()

echo json_encode($data);

Example output:

[
  {
    "time": "3:00",
    "data": {
      "description": "Невеликі високі хмари",
      "temperature": "-3",
      "feelsLike": "-3",
      "pressure": "741",
      "humidity": "85",
      "wind": "1.3",
      "precipitationProbability": "17"
    }
  },
  {
    "time": "9:00",
    "data": {
      "description": "Хмарно з проясненнями",
      "temperature": "0",
      "feelsLike": "-3",
      "pressure": "740",
      "humidity": "84",
      "wind": "2",
      "precipitationProbability": "58"
    }
  },
  {
    "time": "15:00",
    "data": {
      "description": "Суцільна хмарність",
      "temperature": "+4",
      "feelsLike": "+1",
      "pressure": "740",
      "humidity": "55",
      "wind": "4.3",
      "precipitationProbability": "76"
    }
  },
  {
    "time": "21:00",
    "data": {
      "description": "Невелика хмарність",
      "temperature": "+1",
      "feelsLike": "-1",
      "pressure": "742",
      "humidity": "57",
      "wind": "1.7",
      "precipitationProbability": "47"
    }
  }
]

📄 License

MIT License. See LICENSE for details.

🏙 Supported Cities

You can pass any city slug used in the sinoptik.ua URL structure, such as: kyiv lviv kharkiv odesa dnipro

❗ Notes

This library relies on HTML structure of sinoptik.ua, which may change.
Use responsibly — excessive scraping may lead to IP blocking.
This package requires the minimal version of PHP 8.4.

vkarchevskyi / sinoptik.ua-parser

Maintainers

Details