waghbhaskar/data-canvas

A PHP class for mapping dataset from various sources

dev-main 2025-08-17 17:44 UTC

MIT

• Bhaskar Wagh

README

DataSetMapper is a robust PHP 8.1+ library that helps you standardize input datasets from multiple sources (CSV, JSON, TXT, Arrays) into a consistent, client-specific format.

✨ Key Features

• 📥 Flexible Data Loading → Load data from .csv, .json (file/string), delimited .txt, and native PHP arrays.
• 🗺️ Customizable Mapping Schema → Use simple associative arrays to map source → target fields.
• 🛡️ Resilient Error Handling → Handles file not found, invalid JSON, malformed TXT, etc.
• ⚡ Modern PHP 8.1+ Support → Strict typing, readonly, attributes, and latest PHP features.
• 🧩 Null-safe Missing Fields → Missing fields become null with warnings instead of breaking execution.

📦 Installation

composer require waghbhaskar/data-canvas

🚀 Quick Start

1️⃣ Define Mapping Schema
2️⃣ Instantiate Mapper
3️⃣ Load & Map CSV Data

(See GitHub repo for full examples with CSV, JSON, TXT, and PHP Arrays)

🌐 Web Demo

Use the included index.php + output.php.
Run local server → Upload file → Choose type → Map fields → Process Data.

🤝 Contributing

We welcome contributions! 🚀

• Open an issue
• Fork & submit PRs

📜 License

This project is licensed under the MIT License.