phpMyEdit

1. Overview

   How many times have you hand coded a MySQL table editor in PHP?
   phpMyEdit application provides an instant table editor.

   phpMyEdit generates PHP code for displaying/editing MySQL tables
   in HTML. All you need to do is to write a simple calling program
   (a utility to do this is included). It includes a huge set of
   table manipulation functions (record adition, change, view, copy,
   and remove), table sorting, filtering, table lookups, and more.

   phpMyEdit has been renamed phpMariaEdit for the repository only.
   This is to avoid confusion with the numerous instances for phpMyEdit
   that are no longer maintained. Ultimate goal is to have this version
   merged into the official phpMyEdit repository at some point in
   the future.

2. Installation

   For quick installation follow these steps:

   1. Extract phpMyEdit distribution archive.
   2. Copy/ftp/whatever them to your development web site.
   3. Using a browser, run phpMyEditSetup.php to log on
      to your MySQL server.
   4. Select a database, table and table key.
   5. Script phpMyEditSetup.php will attempt to write one or
      multiple files and it will also display those on the screen.
   6. If the file write to the directory where the files were to be
      written fails, copy it into your PHP editor, save it to a file,
      and then run it in the same directory that you used for
      phpMyEditSetup.php file.

   Portions of the generated PHP file are commented and described.
   However phpMyEdit has amount of available features, so if there is
   anything you do not understand, look into official phpMyEdit
   documentation.

3. Documentation

   phpMyEdit comes with extensive and exhaustive documentation in SGML,
   HTML and PDF format with huge amount of options, possibilities and
   information described. It is available for download as a separate
   package from phpMyEdit homepage or its project management page.

   The documentation set (PDF/SGML/HTML) is limited to version 5.7.1.
   Since the new release starting from 5.7.2 and up, some changes
   are made to the application. Those changes have not been integrated
   in the documentation yet but can be found
   here.

   You can find all documentation in the manuals folder.

4. Homepage and download

   The official phpMyEdit homepage for versions up to 5.7.1 is:
   [http://www.phpMyEdit.org]

   The new homepage for phpMyEdit together with the source repository
   for versions after 5.7.1 is:
   [https://sourceforge.net/projects/phpmariaedit/]

   You can download the latest version in "Download" sections
   of these pages.

   Which version to use?

   • 1 on 1 compatibility with 5.7.1 in a maintained repostitory:
     Use 5.7.2
   • using PHP 7.x and 1 on 1 compatibility with 5.7.1: Use 5.7.3
   • using PHP 7.x or 8.x: Use 5.7.4
   • all latest and new features: Use 5.7.5

5. Bug reporting and support

   I'm happy to accept bug reports, feature requests, suggestions for
   improvement, or improved code, preferably via our Platon.SK project
   management interface where everyone can see them.

   If you are submitting a bug report, please include the main table
   schema (mysqldump -d [database_name] [table_name]), schema for
   supporting ['values']['table'] tables, and the contents of the
   generated PHP file in your bug report. Also be sure to strip out
   database host/user/password info from the generated file.

   There is also discussion forum available for asking support
   questions or brainstorming about new features. phpMyEdit has also
   its own mailinglist and CVS repository. All these issues are
   described in official documentation.

   Commercial support is also available; see [http://phpMyEdit.org]
   for more detailed information.

6. Developers

   This project was the brain child of John McCreesh who has now moved
   on to other, more pressing projects. Mr. McCreesh had the foresight
   and fortitude to put together an excellent framework. Second project
   maintainer was Jim Kraai who puts a lot of wonderful feature basis
   and continues development in created framework.

   Many thanks to all those who have contributed code, notes or bug
   reports. Special thanks belongs to Pau Aliagas pau@newtral.com
   who converted phpMyEdit to PHP class in version 3.0.

   Maintainer for versions up to 5.7.1. is Ondrej Jombik with help from
   various phpMyEdit community contributors. See doc/ChangeLog for
   credits.

   Maintainer for versions 5.7.2 onwards is Yves De Billoëz.

7. License

   phpMyEdit is open-source released under GNU: General Public License;
   see doc/COPYING file for more information.

   For the forked version 5.7.2, this is the only valid license.
   SPDX-License-Identifier: GPL-2.0-only

   Commercial licensing for closed source projects based on versions prior
   to 5.7.2 is also possible, see http://phpMyEdit.org website for more
   information.

8. Other information

   This README file was initialy written by John McCreesh, updated by
   Jim Kraai in 3rd December 2001 and updated by Ondrej Jombik in 24th
   September 2002 and 12th February 2003. Further updated by Yves De
   Billoëz on the 23th of December 2023.

   If you find any typo or grammar mistake in this document, feel free
   to send me notice and correction.

this document has been updated on 14/01/2024