com gtk/php-gtk: Bits and pieces around the win32 release: win32/README.txt win32/gtkpath.bat win32/php.ini

Commit:    6e9e5027000e7ed7756051ef2c0444da78a2d3a6
Author:    Steph Fox <[email protected]>         Sat, 15 Jul 2006 01:08:57 +0000
Parents:   36421990dcbb11f773bc73f2781e625f0e33ce98
Branches:  master

Link:       http://git.php.net/?p=gtk/php-gtk.git;a=commitdiff;h=6e9e5027000e7ed7756051ef2c0444da78a2d3a6

Log:
Bits and pieces around the win32 release

Changed paths:
  M  win32/README.txt
  A  win32/gtkpath.bat
  M  win32/php.ini


Diff:
6e9e5027000e7ed7756051ef2c0444da78a2d3a6
diff --git a/win32/README.txt b/win32/README.txt
index a2ef5b4..e1b3cde 100644
--- a/win32/README.txt
+++ b/win32/README.txt
@@ -1,32 +1,55 @@
-Welcome to php-gtk for Win32.
+Welcome to PHP-GTK 2 for Windows
+================================
 
-The Win32 binary distribution for php-gtk is a zip file with this structure
+The win32 binary distribution for PHP-GTK 2 is a zip file with this structure:
 
-\php4				->	php and php-gtk binary files
-\winnt				->	the default php.ini file
-\test				->	a few samples to demonstrate the usage
-README.TXT			->	this file.
+php-gtk				->	PHP-GTK binary files
+					->	gtkpath.bat, a batch file to temporarily set the GTK+ runtime path
+					->	php.ini file with some appropriate settings
+					->	COPYING.LIB (LGPL license)
+					->	NEWS
+					->	README.txt (this file)
+php-gtk\gtk+2.6.9	->	GTK+ 2.6.9 runtime environment
+php-gtk\demos		->	a few samples to demonstrate PHP-GTK usage
+php-gtk\debug-pack	->	debug headers for PHP-GTK 2 and its extensions
 
-How to install install:
+Licensing:
+=========
 
-Copy \php4 to your existing php directory, or a new directory. If this is a new instalation you 
-should create c:\php4 and copy the files to this directory.
+Both PHP-GTK and GTK+ are covered by the LGPL license.
 
-Copy \winnt to you winnt directory. On Windows NT and Windows 2000 that is c:\winnt.
-On Windows 95/98/XP that is c:\windows. If you have an existing php.ini you dont need to copy this file, 
-but make sure you are adding the php-gtk specific options found in \php4\php.ini-gtk.
+You may obtain the sources for PHP-GTK 2 either by downloading the non-binary
+distribution tarball at http://gtk.php.net/download.php or via the php.net CVS
+repository following the instructions on the same page.
 
-You can also install php.ini in yor php directory. This will reduce conflicts with an existing php.ini file 
-in the windows directory.
+You may obtain the sources for GTK+ by downloading the source distribution
+tarballs from ftp://ftp.gtk.org/pub/gtk/v2.6/. This distribution of PHP-GTK 2
+was built against GTK+ 2.6.9.
 
-Copy \test to the location where you want to run your scripts (c:\php4\test)
+How to install PHP-GTK 2:
+========================
 
-How to use:
+NOTE: THIS RELEASE OF PHP-GTK 2 WILL ONLY WORK WITH PHP 5.1.*
 
-Php-gtk applications can be started from the command line (or a shortcut) with this syntax:
+Unzip the archive in a place of your choice. It will create a directory named
+php-gtk containing everything in this distribution.
 
-	c:\php4\php c:\php4\test\hello.php
+You will need to put a copy of php.exe (the CLI version) and php5ts.dll into the
+top level php-gtk directory, alongside the binaries for any other PHP extensions
+you intend to use.
 
-or to avoid the dos-box
+Check the php.ini and make sure the settings there are sane for your system. You
+may add further PHP-specific settings anywhere between [PHP] and [PHP-GTK].
 
-	c:\php4\php_win c:\php4\test\gtk.php
+How to use PHP-GTK 2:
+====================
+
+You will need to either set your PATH to include the gtk+2.6.9 directory, or use
+the batch file supplied to set both it and the path to php-gtk for the duration
+of the current commandline session. To do this, check that the absolute paths
+in gtkpath.bat are correct for your setup, open up your commandline, cd to your
+php-gtk directory and type 'gtkpath'.
+
+PHP-GTK applications can be started from the command line (or a shortcut) with this syntax:
+
+	php demos\phpgtk2-demo.php
diff --git a/win32/gtkpath.bat b/win32/gtkpath.bat
new file mode 100644
index 0000000..5dd2390
--- /dev/null
+++ b/win32/gtkpath.bat
@@ -0,0 +1,5 @@
+@ECHO OFF
+REM Change this to reflect the absolute path to your PHP-GTK installation directory
+REM rather than \php-gtk
+REM Open up your commandline and type 'gtkpath' to load the GTK+ 2.6.9 runtime
+SET PATH=%PATH%;\php-gtk;\php-gtk\gtk+2.6.9
diff --git a/win32/php.ini b/win32/php.ini
index aeb82db..6b5bab2 100644
--- a/win32/php.ini
+++ b/win32/php.ini
@@ -1,4 +1,4 @@
-[PHP-GTK]
+[PHP]
 
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 ; About the php.ini in PHP-GTK ;
@@ -7,26 +7,33 @@
 ; This file introduces the php.ini settings that you will need in order to
 ; run PHP-GTK on your system. You may also need other settings from PHP's
 ; standard php.ini file, e.g. to load further extensions or otherwise control
-; PHP's behaviour in matters such as error reporting.
+; PHP's behaviour in matters such as error reporting. Please add those in
+; the upper part of this file, in the PHP section.
 
-; You may use either PHP's CGI or CLI executable to run PHP-GTK. This php.ini
-; file should be in the same directory as the PHP executable, to avoid conflict
+; You should use PHP's CLI executable to run PHP-GTK. This php.ini file
+; should be in the same directory as the PHP executable, to avoid conflict
 ; with any other copies of PHP that may be installed on your machine.
 
 ; The first thing you will need to do is tell PHP where you want it to look
 ; for the PHP extension libraries (php_*.dll or php_*.so files) on your system.
 
-;extension_dir = "./"
+extension_dir = "./"
 
 ; Make sure that php-gtk2.dll under Windows, or php-gtk2.so under Unix, is in
 ; the directory named in extension_dir alongside any other shared PHP extensions
 ; you intend to use, and tell PHP to load it.
 
-;extension = php-gtk2.**
+extension = php-gtk2.dll
 ;extension = php_pdo.**
 ;extension = php_sqlite.**
 ;extension = php_pdo_sqlite.**
 
+[Date]
+; Defines the default timezone used by the date functions
+date.timezone = Europe/London
+
+[PHP-GTK]
+
 ;;;;;;;;;;;;;;;;;;;;;;
 ; PHP-GTK extensions ;
 ;;;;;;;;;;;;;;;;;;;;;;
@@ -36,7 +43,7 @@
 ; files need to be in the same directory as the PHP-GTK library, along with
 ; any other PHP extensions you are using.
 
-;php-gtk.extensions = 
+php-gtk.extensions = php_gtk_libglade2.dll
 
 ;;;;;;;;;;;;;
 ; Code Page ;
@@ -55,4 +62,4 @@
 ; http://www.microsoft.com/globaldev/reference/cphome.mspx for a list of
 ; the code pages and character sets that are supported on Windows systems.
 
-;php-gtk.codepage = CP1250
+php-gtk.codepage = CP1250