JSON to PHP Array Converter Specification

Overview

A high-performance, browser-based utility that converts JSON strings into valid PHP array syntax. The tool focuses on developer productivity, offering instant formatting, syntax validation, and export capabilities.

Technical Requirements

• Architecture: Single HTML file using vanilla JavaScript, HTML5, and CSS3.
• Frameworks: Tailwind CSS (via CDN) for styling; Lucide Icons (via CDN) for UI elements.
• Storage: ABSOLUTELY NO localStorage, cookies, or IndexedDB. State must be managed in-memory.
• Iframe Safety: No use of alert(), confirm(), or prompt(). All notifications must be custom DOM elements (toast/modal).

UI/UX Design

• Color Palette: A vibrant, professional light-mode aesthetic using Slate-50 as the background, White as the primary container color, and Indigo-600 for primary actions.
• Layout:
  • Header: Simple, clean branding: "JSON to PHP Array Converter".
  • Main Area: A split-pane interface (side-by-side on desktop, stacked on mobile).
    • Left Pane: A high-quality textarea with line numbering and syntax highlighting capabilities (using basic CSS).
    • Right Pane: Read-only output area for the generated PHP code.
  • Actions: A toolbar between panes containing "Convert", "Clear", "Copy", and "Download" buttons.

Features

• Live Conversion: Automatic or button-triggered conversion with real-time JSON validation.
• Configuration Options:
  • Selectable syntax style: Legacy array() or modern short [] syntax.
  • Indentation control (2-space, 4-space, or tab).
  • Variable assignment option: Add $data = ...; prefix.
• Error Handling: Real-time visual feedback for malformed JSON using a non-intrusive floating toast notification.
• Micro-interactions:
  • Smooth hover states on all buttons.
  • Copy-to-clipboard success animation (checkmark icon toggle).
  • Responsive layout shifts seamlessly from vertical to horizontal based on viewport width.

Implementation Directives

1. Validation Logic: Use JSON.parse() within a try-catch block to validate input. Provide clear feedback messages in the UI for syntax errors.
2. Conversion Logic: Write a recursive function that iterates through the JSON object. Check types (string, boolean, number, array, object) and map them to their corresponding PHP types (e.g., boolean true becomes true, null becomes null).
3. Sanitization: Ensure all output is sanitized to prevent XSS if the user attempts to render output back into the DOM. Use textContent or similar methods.
4. Download Functionality: Use a Blob object to generate a application/octet-stream file for immediate downloading of the generated PHP array as a .php file.